> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/prd/phase_41/session_11_local_agent_contract_parity.md). # Session 11: Local Agent Contract Parity **Session ID**: `phase41-session11-local-agent-contract-parity` **Status**: Not Started **Estimated Tasks**: \~12-25 **Estimated Duration**: 2-4 hours *** ## Objective Bring the shipped local-agent contract into full all-access parity with real writes, commands, processes, filesystem operations, marketplace actions, OAuth actions, imports, config mutation, visible results, recovery paths, and tests. *** ## Scope ### In Scope (MVP) * Audit `docs/local-agent-contract.md` and related local-agent code and claims. * Implement real app-server writes, turn control, command execution, process execution, filesystem operations, marketplace install/remove/update, OAuth login/logout/status, external-agent import, and config mutation flows where shipped. * Wire retained actions through product UI or local bridge routes. * Add visible result surfaces and recovery paths for real blockers. * Update local-agent contract tests and route/component tests. ### Out of Scope * OpenClaw action execution owned by Session 09. * Claude Code execution owned by Session 10. *** ## Prerequisites * [ ] Session 09 OpenClaw action execution is complete. * [ ] Session 10 Claude Code execution is complete. *** ## Deliverables 1. Local-agent capabilities that execute for real with visible results. 2. Updated product and contract behavior for app-server readiness and local mutations. 3. Tests covering success and recoverable failure paths. *** ## Success Criteria * [ ] No shipped local-agent surface is observe-only, metadata-only, or manually disabled by default. * [ ] Each retained local-agent capability proves execution, result reporting, recovery guidance, and tests. * [ ] Contract docs match implemented behavior. *** ## Folded Handoff Session Details The following session-specific details were migrated from the former ongoing-projects handoff. They preserve the original objective, scope, outputs, dependencies, notes, and acceptance checks for this session. #### Session 11: Local Agent Contract Parity **Objective**: Bring the shipped local-agent contract into full all-access parity with real writes, commands, processes, filesystem operations, marketplace actions, OAuth actions, imports, config mutation, visible results, recovery paths, and tests. **Scope**: * Audit `docs/local-agent-contract.md`, related local-agent code, app-server readiness, command, process, filesystem, marketplace, OAuth, external-agent import, and config mutation claims. * Implement real app-server writes, turn control, command execution, process execution, filesystem operations, marketplace install/remove/update, OAuth login/logout/status, external-agent import, and config mutation flows where the product exposes them as shipped capabilities. * Add visible result surfaces and recovery paths for missing credentials, missing dependencies, provider failures, offline services, and production/demo boundaries. * Wire each retained local-agent action through product UI or local bridge routes so it executes for real instead of reporting observe-only or metadata-only status. * Update local-agent contract tests and any route/component tests tied to these capabilities. **Outputs**: * Local-agent capabilities that execute for real with visible results, recovery paths, and tests. * Updated product and contract behavior for app-server readiness and local mutations. * Tests covering success and recoverable failure paths. **Dependencies / Notes**: * Depends on Sessions 09 and 10 because OpenClaw and Claude Code are core local-agent execution surfaces. * Do not resolve this as a documentation-only session if product UI or APIs still expose non-executing capabilities. **Acceptance Checks**: * No shipped local-agent surface is observe-only, metadata-only, or manually disabled by default. * Each local-agent capability proves execution, visible result reporting, recovery guidance, and tests. * App-server write, turn-control, command, process, filesystem, marketplace, OAuth, external-agent import, and config mutation flows are implemented with full local access. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/prd/phase_41/session_11_local_agent_contract_parity.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.