Files

-Puter e744ac4687 Add Zopu dev bootstrap: git runtimes, Codex agent-os, dev agent

A vertical slice to bootstrap the product loop on the canonical zopu-code repo.

Primitives (packages/primitives, all tested + lint/type clean):
- GitRemoteRuntime: Gitea REST client (createIssue, createBranch,
  createPullRequest, listIssues, getIssue) as an Effect context service with
  a fetch-backed transport. Live-verified against puter/zopu-code.
- GitLocalRuntime: clone, addWorktree, commit, push, currentBranch,
  setRemoteUrl over a pluggable Shell (host subprocess now, AgentOS VM exec
  later). Tested against real temp git repos.
- agent-os: Codex support via @agentos-software/codex-cli — codexSoftware
  bundle (codex+git), makeCodexAgentOsConfig(), codexSessionEnv() for the
  OpenAI base URL/key.

Env:
- GITEA_URL/GITEA_TOKEN wired into convex.ts and convex.config.ts.
- .env.example documents the self-hosted git section.

Agents (packages/agents):
- zopu-dev: development agent that creates issues on the canonical repo and
  starts autonomous work runs. git-remote tools (create/list/branch/PR) wired
  to GitRemoteRuntime; start_workflow tool enqueues a work run.
- flue run zopu-dev verified live (lists/creates issues on real Gitea).

Backend (packages/backend):
- workflows.startIssueWork mutation: fetches a Gitea issue server-side and
  admits a queued work run. The Codex VM spawn body is the next step.

2026-07-25 03:18:23 +05:30

_generated

feat: wire mobile workspace into project loop

2026-07-24 03:17:59 +05:30

agentWorkspace.ts

Merge branch 'puter/issue-5-gitea-lifecycle' into puter/issue-14-integration

2026-07-24 02:31:21 +05:30

artifactModel.ts

feat: add Convex project backend with generic storage and org-scoped authz

2026-07-23 18:16:41 +05:30

auth.config.ts

initial commit

2026-07-19 02:46:47 +05:30

auth.ts

feat: consolidate web auth and add Effect v4 Project primitives

2026-07-23 18:04:02 +05:30

authz.ts

feat: add Convex project backend with generic storage and org-scoped authz

2026-07-23 18:16:41 +05:30

conversationIngress.smoke.test.ts

feat(chat): scope agent to current organization

2026-07-23 16:31:52 +05:30

conversationMessages.test.ts

feat(chat): scope agent to current organization

2026-07-23 16:31:52 +05:30

conversationMessages.ts

feat(chat): scope agent to current organization

2026-07-23 16:31:52 +05:30

convex.config.ts

Add Zopu dev bootstrap: git runtimes, Codex agent-os, dev agent

2026-07-25 03:18:23 +05:30

daemonCommands.ts

Apply the bracketed Convex API module references required by the kebab-case module rename

2026-07-23 00:50:08 +05:30

daemonRuntime.ts

Add AgentOS daemon control plane and maintenance tooling

2026-07-19 06:29:51 +05:30

daemons.ts

Add AgentOS daemon control plane and maintenance tooling

2026-07-19 06:29:51 +05:30

fluePersistence.ts

Add Flue persistence backend on Convex

2026-07-19 17:29:30 +05:30

healthCheck.ts

initial commit

2026-07-19 02:46:47 +05:30

http.ts

initial commit

2026-07-19 02:46:47 +05:30

linkedSignals.test.ts

test(signals): linked-signals query coverage and deterministic ordering

2026-07-24 21:36:54 +05:30

organizations.test.ts

feat(authz): add organization member authorization check

2026-07-23 15:42:51 +05:30

organizations.ts

feat: consolidate web auth and add Effect v4 Project primitives

2026-07-23 18:04:02 +05:30

privateData.ts

initial commit

2026-07-19 02:46:47 +05:30

projectArtifacts.ts

feat: add Convex project backend with generic storage and org-scoped authz

2026-07-23 18:16:41 +05:30

projectEvents.test.ts

Merge branch 'puter/issue-5-gitea-lifecycle' into puter/issue-14-integration

2026-07-24 02:31:21 +05:30

projectIssueRequests.smoke.test.ts

feat: dispatch authenticated project issue requests

2026-07-24 02:00:02 +05:30

projectIssues.ts

Merge branch 'puter/issue-5-gitea-lifecycle' into puter/issue-14-integration

2026-07-24 02:31:21 +05:30

projects.ts

merge mobile workspace UI into integration

2026-07-24 03:00:08 +05:30

projectStore.ts

fix: lint cleanup, remove tests for later rewrite, ES compat

2026-07-23 18:48:26 +05:30

publicGit.ts

feat: wire mobile workspace into project loop

2026-07-24 03:17:59 +05:30

README.md

Declare typed Convex env and route auth through @code/env/convex

2026-07-19 17:29:21 +05:30

schema.ts

feat(signals): project-scoped Zopu routing loop with secure tools

2026-07-24 20:48:18 +05:30

signalRouting.test.ts

feat(signals): project-scoped Zopu routing loop with secure tools

2026-07-24 20:48:18 +05:30

signalRouting.ts

feat(signals): project-scoped Zopu routing loop with secure tools

2026-07-24 20:48:18 +05:30

signals.test.ts

fix(signals): source order follows agent selection, not chronological timestamps

2026-07-24 20:32:48 +05:30

signals.ts

test(signals): linked-signals query coverage and deterministic ordering

2026-07-24 21:36:54 +05:30

todos.ts

initial commit

2026-07-19 02:46:47 +05:30

tsconfig.json

initial commit

2026-07-19 02:46:47 +05:30

workflows.ts

Add Zopu dev bootstrap: git runtimes, Codex agent-os, dev agent

2026-07-25 03:18:23 +05:30

README.md

Convex Backend

This directory contains the Convex control plane for the app and daemon runtime. Generated files under _generated/ are maintained by Convex and should not be edited by hand.

Daemon Control Plane

schema.ts defines daemon definitions, high-churn daemon presence, leased daemon commands, append-only command events, and the sample todos table.
daemons.ts manages stable daemon definitions with upsert, get, and list.
daemonRuntime.ts records daemon session lifecycle: connect, heartbeat, disconnect, recordEvent, and bounded event listing.
daemonCommands.ts owns the command queue: enqueue, available, claim, start, succeed, fail, cancel, and bounded command listing.

Commands are claimed by daemon session. Preserve the claimedBySessionId ownership checks, leaseExpiresAt expiry semantics, terminal statuses, and bounded query results when changing this flow.

Usage

Convex functions are exposed by file path through the generated api object, for example api.daemonCommands.enqueue or api.daemonRuntime.connect. Run bun run dev:server from the repository root to start the development deployment, and bun run dev:setup when configuring Convex for the first time.