How goshikavs/goshikq-agent-framework works
Goshikq is an AI agent framework: Python and TypeScript SDKs define agents, tools, and goal contracts; a Rust server/runtime executes runs and verifies outcomes against state. The product also provides durable recovery, multi-agent and workflow execution, approvals, evidence/change-impact analysis, protocol integrations, and Studio’s execution explorer. The graph follows documented SDK-to-runtime and Studio-to-runtime flows; unsampled subsystems are represented from README capabilities, with links omitted where implementation-level callers were not shown.
Main entry points: runtime.rs Runtime · runs.rs HTTP API · client.py Runtime Clients · agent.py Agent Definitions
Components 24
Agent SDKs
- Agent Definitions
sdk/python/src/goshikq_ai/agent.py - Goals and Tools
sdk/python/src/goshikq_ai/goal.py - Python Worker
sdk/python/src/goshikq_ai/worker.py - TypeScript Worker
sdk/typescript/src/worker.ts - Runtime Clients
sdk/python/src/goshikq_ai/client.py
Execution Runtime
- Run Protocol
crates/goshikq-protocol/src/run.rs - Runtime
crates/goshikq-runtime/src/runtime.rs - Execution Loop
crates/goshikq-runtime/src/executor.rs - Durable Recovery
crates/goshikq-runtime/src/supervisor.rs - Workflow Engine
crates/goshikq-runtime/src/workflow_exec.rs
Server and API
- HTTP API
crates/goshikq-server/src/routes/runs.rs - Delegated Tasks
crates/goshikq-server/src/routes/tasks.rs - Capability Catalog
crates/goshikq-server/src/routes/catalog.rs - Auth and Tenancy
crates/goshikq-server/src/auth.rs - Server Configuration
crates/goshikq-server/src/config.rs
Durability and Evidence
- Evidence Coverage
crates/goshikq-core/src/coverage.rs - Impact Revalidation
crates/goshikq-core/src/impact.rs - Run and Event Store
crates/goshikq-storage/src/runs.rs - Approval Gates
crates/goshikq-storage/src/approvals.rs
Studio Console
- Execution Explorer
apps/studio/src/app/executions/[id]/page.tsx - Runtime Proxy
apps/studio/src/app/api/runtime/[...path]/route.ts
Other components
- Agent Developer
- PostgreSQL
- External Trace Sources
Connections 21
- Agent Developer → Agent Definitions: defines agent
README.md - Agent Definitions → Goals and Tools: declares goals
README.md - Python Worker → Runtime Clients: polls and responds
sdk/python/src/goshikq_ai/worker.py - TypeScript Worker → Runtime Clients: polls and responds
sdk/typescript/src/worker.ts - Runtime Clients → HTTP API: calls API
README.md - HTTP API → Auth and Tenancy: authorizes requests
crates/goshikq-server/src/auth.rs - HTTP API → Runtime: dispatches runs
README.md - Runtime → Execution Loop: executes runs
crates/goshikq-runtime/src/runtime.rs - Runtime → Run Protocol: uses run protocol
crates/goshikq-runtime/src/runtime.rs - Runtime → Run and Event Store: persists runs
README.md - Run and Event Store → PostgreSQL: stores durable data
README.md - Runtime → Durable Recovery: supervises recovery
crates/goshikq-runtime/src/runtime.rs - Runtime → Workflow Engine: executes workflows
README.md - Runtime → Approval Gates: gates actions
- Runtime → Evidence Coverage: checks evidence
- Runtime → Impact Revalidation: revalidates changes
- Runtime → Delegated Tasks: delegates tasks
- HTTP API → Capability Catalog: serves capabilities
- Execution Explorer → Runtime Proxy: requests runtime data
README.md - Runtime Proxy → HTTP API: proxies requests
README.md - External Trace Sources → HTTP API: ingests OTLP
README.md