feat: unify agentic runtime and Product App lifecycle

AGENTS-CN.md

@@ -128,8 +128,9 @@ await api.invoke('your_command', { request: { /* fields */ } });
 - 项目本地配置位于 `<workspace>/.sparo_os/config/`。
 - 默认 debug log 位于 `<workspace>/.sparo_os/debug.log`。
 - 运行时工作区数据通常位于 `<app-root>/workspaces/<workspace-id>/`。
-- 项目 sessions 位于 `<app-root>/workspaces/<workspace-id>/sessions/`。
-- Agentic OS 全局 sessions 位于 `<app-root>/agentic_os/sessions/`。
+- Agentic OS 会话位于 `<app-root>/sessions/os_agent/`。
+- 全局智能应用会话位于 `<app-root>/sessions/global/`。
+- Workspace 会话位于 `<app-root>/sessions/workspaces/<workspace-id>/`。
 
 桌面运行时日志：
 

AGENTS.md

@@ -131,8 +131,9 @@ Backend logging:
 - Project-local config lives under `<workspace>/.sparo_os/config/`.
 - Default debug log lives at `<workspace>/.sparo_os/debug.log`.
 - Runtime workspace data typically lives under `<app-root>/workspaces/<workspace-id>/`.
-- Project sessions live under `<app-root>/workspaces/<workspace-id>/sessions/`.
-- Agentic OS global sessions live under `<app-root>/agentic_os/sessions/`.
+- Agentic OS sessions live under `<app-root>/sessions/os_agent/`.
+- Global intelligent-app sessions live under `<app-root>/sessions/global/`.
+- Workspace sessions live under `<app-root>/sessions/workspaces/<workspace-id>/`.
 
 Desktop runtime logs:
 

bundles/product-apps/builtin-deep-research/1.0.1/app.json

@@ -0,0 +1,211 @@
+{
+  "id": "builtin-deep-research",
+  "version": "1.0.1",
+  "name": "Deep Research",
+  "description": "A deep research Agent for finding sources, comparing viewpoints, organizing evidence, and turning complex questions into clear conclusions.",
+  "i18n": {
+    "locales": {
+      "en-US": {
+        "name": "Deep Research",
+        "description": "A deep research Agent for finding sources, comparing viewpoints, organizing evidence, and turning complex questions into clear conclusions.",
+        "tags": [
+          "built-in",
+          "research",
+          "evidence",
+          "report"
+        ]
+      },
+      "zh-CN": {
+        "name": "Deep Research",
+        "description": "面向深度研究的 Agent，适合查资料、比观点、梳理依据，把复杂问题沉淀为清晰结论。",
+        "tags": [
+          "内置",
+          "研究",
+          "证据",
+          "报告"
+        ]
+      }
+    }
+  },
+  "interactionModel": "conversation",
+  "workMultiplicity": "multiple",
+  "workObjectKinds": [
+    {
+      "id": "research-question",
+      "label": "Research Question",
+      "scope": "workspace",
+      "identitySchema": {
+        "type": "object",
+        "properties": {
+          "questionId": {
+            "type": "string"
+          },
+          "topic": {
+            "type": "string"
+          }
+        }
+      },
+      "contextSchema": {
+        "type": "object",
+        "properties": {
+          "scope": {
+            "type": "string"
+          },
+          "sources": {
+            "type": "array"
+          },
+          "openQuestions": {
+            "type": "array"
+          }
+        }
+      }
+    },
+    {
+      "id": "evidence-set",
+      "label": "Evidence Set",
+      "scope": "asset",
+      "identitySchema": {
+        "type": "object",
+        "properties": {
+          "evidenceSetId": {
+            "type": "string"
+          },
+          "artifactId": {
+            "type": "string"
+          }
+        }
+      },
+      "contextSchema": {
+        "type": "object",
+        "properties": {
+          "claims": {
+            "type": "array"
+          },
+          "citations": {
+            "type": "array"
+          },
+          "confidence": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "id": "research-report",
+      "label": "Research Report",
+      "scope": "asset",
+      "identitySchema": {
+        "type": "object",
+        "properties": {
+          "artifactId": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
+        }
+      },
+      "contextSchema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string"
+          },
+          "audience": {
+            "type": "string"
+          },
+          "sections": {
+            "type": "array"
+          }
+        }
+      }
+    }
+  ],
+  "primarySurface": {
+    "componentId": "builtin-deep-research-chat-surface",
+    "surfaceId": "primary"
+  },
+  "primarySurfaceMode": "chatPrimary",
+  "components": [
+    {
+      "componentId": "builtin-deep-research-chat-surface",
+      "kind": "surface",
+      "source": "private",
+      "role": "primarySurface",
+      "capabilities": [
+        "chatPrimary"
+      ],
+      "usesCapabilities": [
+        "session.read",
+        "component.run"
+      ]
+    },
+    {
+      "componentId": "builtin-deep-research-agent",
+      "kind": "agent",
+      "source": "private",
+      "role": "assistant",
+      "capabilities": [
+        "parallelResearch",
+        "synthesizeReport"
+      ],
+      "usesCapabilities": [
+        "browser.navigate",
+        "browser.inspect",
+        "session.read",
+        "session.write",
+        "memory.read",
+        "memory.write",
+        "model.invoke",
+        "tool.invoke"
+      ]
+    }
+  ],
+  "componentLockId": "",
+  "permissions": {
+    "fs": true,
+    "net": true,
+    "shell": true,
+    "gui": false,
+    "secrets": false,
+    "ai": true
+  },
+  "installScope": "system",
+  "catalogVisibility": "discoverable",
+  "enabled": true,
+  "icon": {
+    "kind": "packageAsset",
+    "path": "assets/icon.svg"
+  },
+  "category": "analysis",
+  "tags": [
+    "built-in",
+    "research",
+    "evidence",
+    "report"
+  ],
+  "launch": {
+    "kind": "agentSession",
+    "targetId": "DeepResearch",
+    "scopeRequirement": "workspaceOptional",
+    "agentType": "DeepResearch",
+    "surfaceId": "primary"
+  },
+  "osCapabilities": [
+    "session.read",
+    "component.run",
+    "browser.navigate",
+    "browser.inspect",
+    "session.write",
+    "memory.read",
+    "memory.write",
+    "model.invoke",
+    "tool.invoke"
+  ],
+  "dataLifecycle": {
+    "retention": "workRuntimeScoped",
+    "deletion": "deleteWithWork",
+    "migration": "exportImport",
+    "share": "declaredWorkObjectsOnly"
+  }
+}

bundles/product-apps/builtin-deep-research/1.0.1/components/agents/builtin-deep-research-agent/component.json

@@ -0,0 +1,63 @@
+{
+  "id": "builtin-deep-research-agent",
+  "kind": "agent",
+  "name": "Deep Research Agent",
+  "description": "Research agent for parallel investigation, source review, and synthesized report writing.",
+  "packageSource": "appPrivate",
+  "ownerApp": {
+    "appId": "builtin-deep-research",
+    "appVersion": "1.0.1"
+  },
+  "capabilities": [
+    {
+      "id": "parallelResearch",
+      "title": "Parallel research",
+      "description": "Dispatch and coordinate focused research subtasks.",
+      "actions": [
+        "dispatchResearch",
+        "readSources"
+      ]
+    },
+    {
+      "id": "synthesizeReport",
+      "title": "Synthesize report",
+      "description": "Compare findings and produce a cohesive research report.",
+      "actions": [
+        "synthesize",
+        "writeReport"
+      ]
+    }
+  ],
+  "permissions": [
+    {
+      "kind": "ai",
+      "summary": "Uses the configured Deep Research agent.",
+      "scopes": [
+        "DeepResearch"
+      ]
+    },
+    {
+      "kind": "net",
+      "summary": "Uses web research tools when the user requests current or public-source research.",
+      "scopes": [
+        "*"
+      ]
+    }
+  ],
+  "usedByApps": [
+    "builtin-deep-research"
+  ],
+  "visibility": "appDependency",
+  "dependencies": [],
+  "implementationRef": "agent://DeepResearch",
+  "usesCapabilities": [
+    "browser.navigate",
+    "browser.inspect",
+    "session.read",
+    "session.write",
+    "memory.read",
+    "memory.write",
+    "model.invoke",
+    "tool.invoke"
+  ]
+}

bundles/product-apps/builtin-deep-research/1.0.1/components/surfaces/builtin-deep-research-chat-surface/component.json

@@ -0,0 +1,44 @@
+{
+  "id": "builtin-deep-research-chat-surface",
+  "kind": "surface",
+  "name": "Deep Research Chat",
+  "description": "Conversation-first work surface for research planning, investigation, and synthesis.",
+  "packageSource": "appPrivate",
+  "ownerApp": {
+    "appId": "builtin-deep-research",
+    "appVersion": "1.0.1"
+  },
+  "capabilities": [
+    {
+      "id": "chatPrimary",
+      "title": "Primary chat",
+      "description": "Uses the Flow Chat surface as the Product App's primary workspace.",
+      "actions": [
+        "startSession",
+        "continueWork"
+      ]
+    }
+  ],
+  "permissions": [],
+  "usedByApps": [
+    "builtin-deep-research"
+  ],
+  "visibility": "appDependency",
+  "dependencies": [
+    {
+      "componentId": "builtin-deep-research-agent",
+      "kind": "agent",
+      "source": "private",
+      "role": "assistant",
+      "capabilities": [
+        "parallelResearch",
+        "synthesizeReport"
+      ]
+    }
+  ],
+  "implementationRef": "app://builtin-deep-research@1.0.1/surfaces/builtin-deep-research-chat-surface",
+  "usesCapabilities": [
+    "session.read",
+    "component.run"
+  ]
+}

bundles/product-apps/builtin-deep-research/1.0.1/components/surfaces/builtin-deep-research-chat-surface/source/index.html

@@ -0,0 +1 @@
+<main id="app-root" class="package-surface"></main>