Skip to content

Embedded Python runtime proof-of-concept requirements

These requirements track the live implementation of the embedded Python runtime proof of concept.

ID Requirement Implementation Verification Documentation Evidence
IPR-001 A release-like iOS application bundle contains and starts the fixed CPython/Crystal Lattice closure without a desktop process, loopback application server, runtime download, or dynamic plugin installation. Implemented Automated Documented Pinned Python Apple Support preparation; signed simulator and physical-device Release builds; focused Detox imports real agent_core/agent_app and constructs AgentApplication; embedded-runtime development guide
IPR-002 The mobile application exposes the embedded runtime through a production inProcess AgentBackend that supports the fixed agent, sessions, messages, request events, cancellation, and the proof-of-concept configuration action. Implemented Automated Documented Native JSON transport plus RestAgentBackend(kind: "inProcess"); host integration; focused SDK tests; diagnostics covers agents, sessions, events, and messages; production setup Detox covers configuration and reconnect
IPR-003 One fixed agent uses the reference OpenAI-compatible provider through an API-key-protected proxy backed by Ollama and completes a real multi-round request. Implemented Automated Documented Host integration and release-simulator Detox complete two explicit user requests using both Read and Write through authenticated local Ollama qwen3.5:0.8b, with persisted tool messages and verified output content
IPR-004 The proxy rejects missing or incorrect bearer credentials, accepts the configured key, preserves required OpenAI-compatible streaming/non-streaming behavior, and does not log the credential. Implemented Automated Documented Six tools/openai-proxy tests; real API-key-protected Ollama qwen3:0.6b request; proxy README
IPR-005 The app accepts a masked proof-of-concept API key, supplies it through an app-owned configuration overlay, and reconstructs the complete AgentApplication without exposing the key in prompts, events, tools, logs, or committed configuration. Implemented Automated Documented Production setup Detox rejects a wrong key, accepts the correct masked input, persists owner configuration across process relaunch, and reconnects without re-entry; saved connection, prompts, events, tools, proxy logs, and committed config contain no key
IPR-006 General text Read and Write tools operate only on logical paths under one canonical app-owned workspace and reject absolute paths, traversal, and symlink escape. Implemented Automated Documented Focused unit tests cover nested text round trip and reject absolute paths, traversal, and symlink escape; real simulator tool loop verifies the app-owned output
IPR-007 Session and workspace state survive navigation, runtime reconstruction, and process relaunch for the proof-of-concept flow. Implemented Automated Documented Setup Detox reconnects the saved production connection after process relaunch; persistence Detox loads the same session ID, tool messages, and output.txt in a fresh process without replaying the chat request
IPR-008 An active request receives bounded iOS background handling, durable lifecycle timestamps/state, and visible completion or recoverable interruption without automatic duplicate provider execution. Implemented Automated + inspected Documented Native host owns an iOS background task and persists running/background/completed/failed/cancelled/expired/interrupted state; delayed release-simulator Detox backgrounds for five seconds and verifies ordered background/completion timestamps plus final output; expiration and relaunch-interruption paths are inspected
IPR-009 Focused automated simulator coverage exercises production screens and adapters and is sufficient acceptance evidence for the proof of concept. Implemented Automated Documented Production setup, credential-free smoke, real tool-loop persistence, and delayed background continuation pass on an iPhone 17 Pro simulator; simulator sufficiency confirmed by user direction on 2026-09-10
IPR-010 The proof of concept remains limited to one agent/provider, workspace Read/Write, basic credentials, and lifecycle evidence; Tavily search, restricted Python, ChatGPT authorization, local models, and broader production hardening are not falsely presented as delivered. Implemented Inspected Documented Specification exclusions, package README, and embedded-runtime development guide state the delivered scope and current limits