turnloom 0.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- turnloom-0.7.0/AGENTS.md +45 -0
- turnloom-0.7.0/CHANGELOG.md +81 -0
- turnloom-0.7.0/CONTRIBUTING.md +46 -0
- turnloom-0.7.0/Dockerfile +20 -0
- turnloom-0.7.0/LICENSE +21 -0
- turnloom-0.7.0/MANIFEST.in +12 -0
- turnloom-0.7.0/Open Turnloom Studio.cmd +30 -0
- turnloom-0.7.0/PKG-INFO +209 -0
- turnloom-0.7.0/README.md +142 -0
- turnloom-0.7.0/SECURITY.md +61 -0
- turnloom-0.7.0/action.yml +88 -0
- turnloom-0.7.0/docs/banner.svg +25 -0
- turnloom-0.7.0/docs/design.md +79 -0
- turnloom-0.7.0/docs/desktop.md +42 -0
- turnloom-0.7.0/docs/experiments.md +43 -0
- turnloom-0.7.0/docs/integrations.md +230 -0
- turnloom-0.7.0/docs/leaderboard.md +58 -0
- turnloom-0.7.0/docs/providers.md +63 -0
- turnloom-0.7.0/docs/studio-agents.png +0 -0
- turnloom-0.7.0/docs/studio-cost.png +0 -0
- turnloom-0.7.0/docs/studio-documents.png +0 -0
- turnloom-0.7.0/docs/studio-policy.png +0 -0
- turnloom-0.7.0/docs/studio-preview.png +0 -0
- turnloom-0.7.0/examples/manifest.json +9 -0
- turnloom-0.7.0/examples/mcp.json +6 -0
- turnloom-0.7.0/examples/tasks/slugify/slugify.py +8 -0
- turnloom-0.7.0/examples/tasks/slugify/test_slugify.py +21 -0
- turnloom-0.7.0/examples/toolkit/package-lock.json +208 -0
- turnloom-0.7.0/examples/toolkit/package.json +10 -0
- turnloom-0.7.0/examples/toolkit/tools.json +8 -0
- turnloom-0.7.0/integrations/harbor/turnloom_harbor.py +62 -0
- turnloom-0.7.0/integrations/provio/0001-on-decision-observer-and-turnloom-notes.patch +266 -0
- turnloom-0.7.0/integrations/provio/README.md +21 -0
- turnloom-0.7.0/integrations/unwind/0001-native-windows-stdio.patch +70 -0
- turnloom-0.7.0/integrations/unwind/README.md +11 -0
- turnloom-0.7.0/packaging/build.ps1 +17 -0
- turnloom-0.7.0/packaging/entry.py +15 -0
- turnloom-0.7.0/packaging/turnloom-studio.spec +51 -0
- turnloom-0.7.0/packaging/turnloom.ico +0 -0
- turnloom-0.7.0/pyproject.toml +84 -0
- turnloom-0.7.0/scripts/run_action.py +65 -0
- turnloom-0.7.0/scripts/sync_personas.py +68 -0
- turnloom-0.7.0/setup.cfg +4 -0
- turnloom-0.7.0/studio/App.jsx +389 -0
- turnloom-0.7.0/studio/build.mjs +57 -0
- turnloom-0.7.0/studio/loom.css +314 -0
- turnloom-0.7.0/studio/package-lock.json +2117 -0
- turnloom-0.7.0/studio/package.json +32 -0
- turnloom-0.7.0/studio/src/Agent.jsx +963 -0
- turnloom-0.7.0/studio/src/Agents.jsx +292 -0
- turnloom-0.7.0/studio/src/Changes.jsx +132 -0
- turnloom-0.7.0/studio/src/Charts.jsx +155 -0
- turnloom-0.7.0/studio/src/Code.jsx +91 -0
- turnloom-0.7.0/studio/src/Connection.jsx +380 -0
- turnloom-0.7.0/studio/src/Cost.jsx +410 -0
- turnloom-0.7.0/studio/src/Dialog.jsx +83 -0
- turnloom-0.7.0/studio/src/DiffView.jsx +132 -0
- turnloom-0.7.0/studio/src/Documents.jsx +243 -0
- turnloom-0.7.0/studio/src/Editor.jsx +530 -0
- turnloom-0.7.0/studio/src/Files.jsx +306 -0
- turnloom-0.7.0/studio/src/Ledger.jsx +193 -0
- turnloom-0.7.0/studio/src/Loom.jsx +500 -0
- turnloom-0.7.0/studio/src/Page.jsx +91 -0
- turnloom-0.7.0/studio/src/Palette.jsx +180 -0
- turnloom-0.7.0/studio/src/Policy.jsx +272 -0
- turnloom-0.7.0/studio/src/Prose.jsx +114 -0
- turnloom-0.7.0/studio/src/Screens.jsx +127 -0
- turnloom-0.7.0/studio/src/Tools.jsx +139 -0
- turnloom-0.7.0/studio/src/api.js +56 -0
- turnloom-0.7.0/studio/src/diff.js +183 -0
- turnloom-0.7.0/studio/src/icons.jsx +79 -0
- turnloom-0.7.0/studio/src/store.js +320 -0
- turnloom-0.7.0/studio/src/theme.js +28 -0
- turnloom-0.7.0/studio/src/util.js +143 -0
- turnloom-0.7.0/studio/src/views.js +11 -0
- turnloom-0.7.0/studio/studio.css +2152 -0
- turnloom-0.7.0/studio/test-browser.mjs +821 -0
- turnloom-0.7.0/studio/views.css +1226 -0
- turnloom-0.7.0/tests/studio_browser_fixture.py +225 -0
- turnloom-0.7.0/tests/test_acp.py +401 -0
- turnloom-0.7.0/tests/test_agent.py +602 -0
- turnloom-0.7.0/tests/test_extensions.py +225 -0
- turnloom-0.7.0/tests/test_guard.py +171 -0
- turnloom-0.7.0/tests/test_layer.py +454 -0
- turnloom-0.7.0/tests/test_providers.py +93 -0
- turnloom-0.7.0/tests/test_session.py +349 -0
- turnloom-0.7.0/tests/test_studio.py +317 -0
- turnloom-0.7.0/tests/test_tools.py +243 -0
- turnloom-0.7.0/turnloom/__init__.py +3 -0
- turnloom-0.7.0/turnloom/__main__.py +3 -0
- turnloom-0.7.0/turnloom/acp.py +493 -0
- turnloom-0.7.0/turnloom/agent.py +938 -0
- turnloom-0.7.0/turnloom/atif.py +104 -0
- turnloom-0.7.0/turnloom/cli.py +562 -0
- turnloom-0.7.0/turnloom/compare.py +87 -0
- turnloom-0.7.0/turnloom/context.py +99 -0
- turnloom-0.7.0/turnloom/data/LICENSE.models-dev +21 -0
- turnloom-0.7.0/turnloom/data/providers.json +189 -0
- turnloom-0.7.0/turnloom/desktop.py +103 -0
- turnloom-0.7.0/turnloom/evaluate.py +190 -0
- turnloom-0.7.0/turnloom/extensions.py +250 -0
- turnloom-0.7.0/turnloom/gateway.py +144 -0
- turnloom-0.7.0/turnloom/guard.py +231 -0
- turnloom-0.7.0/turnloom/meter.py +129 -0
- turnloom-0.7.0/turnloom/openrouter.py +65 -0
- turnloom-0.7.0/turnloom/personas/LICENSE +21 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-anthropologist.md +125 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-geographer.md +127 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-historian.md +123 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-narratologist.md +118 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-psychologist.md +118 -0
- turnloom-0.7.0/turnloom/personas/academic/academic-statistician.md +144 -0
- turnloom-0.7.0/turnloom/personas/catalog.json +2836 -0
- turnloom-0.7.0/turnloom/personas/design/design-brand-guardian.md +322 -0
- turnloom-0.7.0/turnloom/personas/design/design-image-prompt-engineer.md +236 -0
- turnloom-0.7.0/turnloom/personas/design/design-inclusive-visuals-specialist.md +73 -0
- turnloom-0.7.0/turnloom/personas/design/design-persona-walkthrough.md +272 -0
- turnloom-0.7.0/turnloom/personas/design/design-ui-designer.md +386 -0
- turnloom-0.7.0/turnloom/personas/design/design-ui-finish-gate-reviewer.md +217 -0
- turnloom-0.7.0/turnloom/personas/design/design-ux-architect.md +482 -0
- turnloom-0.7.0/turnloom/personas/design/design-ux-researcher.md +329 -0
- turnloom-0.7.0/turnloom/personas/design/design-visual-storyteller.md +149 -0
- turnloom-0.7.0/turnloom/personas/design/design-whimsy-injector.md +460 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-ai-data-remediation-engineer.md +211 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-ai-engineer.md +146 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-api-platform-engineer.md +181 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-ats-validator-architect.md +383 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-autonomous-optimization-architect.md +121 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-backend-architect.md +255 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-china-network-engineer.md +252 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-cms-developer.md +536 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-code-reviewer.md +76 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-codebase-onboarding-engineer.md +173 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-data-engineer.md +349 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-data-visualization-engineer.md +151 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-database-optimizer.md +188 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-database-reliability-engineer.md +201 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-desktop-app-engineer.md +209 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-developer-tooling-engineer.md +153 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-devops-automator.md +385 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-drupal-performance.md +347 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-drupal-shopping-cart.md +360 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-electrical-engineer.md +575 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-email-intelligence-engineer.md +390 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-embedded-firmware-engineer.md +196 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-feishu-integration-developer.md +606 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-filament-optimization-specialist.md +283 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-finops-engineer.md +164 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-frontend-developer.md +257 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-gaussdb-expert.md +334 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-git-workflow-master.md +98 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-i18n-engineer.md +214 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-identity-access-engineer.md +217 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-incident-response-commander.md +444 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-iot-fleet-engineer.md +148 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-it-service-manager.md +561 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-knowledge-graph-engineer.md +372 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-llm-post-training-engineer.md +166 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-minimal-change-engineer.md +207 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-mobile-app-builder.md +493 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-mobile-release-engineer.md +164 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-multi-agent-systems-architect.md +600 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-network-engineer.md +245 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-orgscript-engineer.md +113 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-payments-billing-engineer.md +228 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-pdf-engine-architect.md +696 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-platform-engineer.md +270 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-privacy-engineer.md +152 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-prompt-engineer.md +209 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-rag-pipeline-engineer.md +450 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-rapid-prototyper.md +466 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-realtime-collaboration-engineer.md +200 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-rust-refactoring-specialist.md +313 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-search-relevance-engineer.md +237 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-section-508-specialist.md +339 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-senior-developer.md +176 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-servicenow-developer-mentor.md +180 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-software-architect.md +112 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-solidity-smart-contract-engineer.md +522 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-sre.md +90 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-technical-writer.md +393 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-universal-document-compiler.md +370 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-uswds-developer.md +340 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-video-streaming-engineer.md +151 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-voice-ai-integration-engineer.md +584 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-webassembly-engineer.md +153 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-wechat-mini-program-developer.md +356 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-wordpress-performance.md +346 -0
- turnloom-0.7.0/turnloom/personas/engineering/engineering-wordpress-shopping-cart.md +346 -0
- turnloom-0.7.0/turnloom/personas/finance/finance-bookkeeper-controller.md +260 -0
- turnloom-0.7.0/turnloom/personas/finance/finance-financial-analyst.md +234 -0
- turnloom-0.7.0/turnloom/personas/finance/finance-fpa-analyst.md +263 -0
- turnloom-0.7.0/turnloom/personas/finance/finance-investment-researcher.md +272 -0
- turnloom-0.7.0/turnloom/personas/finance/finance-tax-strategist.md +239 -0
- turnloom-0.7.0/turnloom/personas/game-development/blender-addon-engineer.md +243 -0
- turnloom-0.7.0/turnloom/personas/game-development/economy-designer.md +156 -0
- turnloom-0.7.0/turnloom/personas/game-development/game-audio-engineer.md +264 -0
- turnloom-0.7.0/turnloom/personas/game-development/game-designer.md +167 -0
- turnloom-0.7.0/turnloom/personas/game-development/godot-gameplay-scripter.md +338 -0
- turnloom-0.7.0/turnloom/personas/game-development/godot-multiplayer-engineer.md +301 -0
- turnloom-0.7.0/turnloom/personas/game-development/godot-shader-developer.md +267 -0
- turnloom-0.7.0/turnloom/personas/game-development/level-designer.md +208 -0
- turnloom-0.7.0/turnloom/personas/game-development/narrative-designer.md +243 -0
- turnloom-0.7.0/turnloom/personas/game-development/roblox-avatar-creator.md +297 -0
- turnloom-0.7.0/turnloom/personas/game-development/roblox-experience-designer.md +306 -0
- turnloom-0.7.0/turnloom/personas/game-development/roblox-systems-scripter.md +332 -0
- turnloom-0.7.0/turnloom/personas/game-development/technical-artist.md +233 -0
- turnloom-0.7.0/turnloom/personas/game-development/unity-architect.md +271 -0
- turnloom-0.7.0/turnloom/personas/game-development/unity-editor-tool-developer.md +310 -0
- turnloom-0.7.0/turnloom/personas/game-development/unity-multiplayer-engineer.md +323 -0
- turnloom-0.7.0/turnloom/personas/game-development/unity-shader-graph-artist.md +269 -0
- turnloom-0.7.0/turnloom/personas/game-development/unreal-multiplayer-architect.md +364 -0
- turnloom-0.7.0/turnloom/personas/game-development/unreal-systems-engineer.md +322 -0
- turnloom-0.7.0/turnloom/personas/game-development/unreal-technical-artist.md +256 -0
- turnloom-0.7.0/turnloom/personas/game-development/unreal-world-builder.md +273 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-3d-scene-developer.md +111 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-analyst.md +91 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-bim-specialist.md +108 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-cartography-designer.md +150 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-drone-reality-mapping.md +120 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-geoai-ml-engineer.md +105 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-geoprocessing-specialist.md +97 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-qa-engineer.md +133 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-solution-engineer.md +101 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-spatial-data-engineer.md +97 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-spatial-data-scientist.md +111 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-technical-consultant.md +86 -0
- turnloom-0.7.0/turnloom/personas/gis/gis-web-gis-developer.md +108 -0
- turnloom-0.7.0/turnloom/personas/healthcare/healthcare-clinical-evidence-agent.md +231 -0
- turnloom-0.7.0/turnloom/personas/healthcare/healthcare-innovation-strategist.md +433 -0
- turnloom-0.7.0/turnloom/personas/healthcare/healthcare-sovereign-health-systems-agent.md +312 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-aeo-foundations.md +264 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-agentic-search-optimizer.md +279 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-ai-citation-strategist.md +172 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-app-store-optimizer.md +321 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-baidu-seo-specialist.md +226 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-bilibili-content-strategist.md +199 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-book-co-author.md +110 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-carousel-growth-engine.md +204 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-china-ecommerce-operator.md +283 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-china-market-localization-strategist.md +283 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-content-creator.md +54 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-cross-border-ecommerce.md +259 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-developer-community-builder.md +285 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-douyin-strategist.md +149 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-email-strategist.md +249 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-global-podcast-strategist.md +206 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-growth-hacker.md +54 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-instagram-curator.md +113 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-kuaishou-strategist.md +223 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-linkedin-content-creator.md +214 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-livestream-commerce-coach.md +305 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-multi-platform-publisher.md +217 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-podcast-strategist.md +277 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-pr-communications-manager.md +473 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-private-domain-operator.md +308 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-reddit-community-builder.md +123 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-seo-specialist.md +370 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-short-video-editing-coach.md +412 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-social-media-strategist.md +125 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-tiktok-strategist.md +125 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-twitter-engager.md +126 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-video-optimization-specialist.md +119 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-wechat-official-account.md +145 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-weibo-strategist.md +240 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-x-twitter-intelligence-analyst.md +161 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-xiaohongshu-specialist.md +138 -0
- turnloom-0.7.0/turnloom/personas/marketing/marketing-zhihu-strategist.md +162 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-auditor.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-creative-strategist.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-paid-social-strategist.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-ppc-strategist.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-programmatic-buyer.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-search-query-analyst.md +71 -0
- turnloom-0.7.0/turnloom/personas/paid-media/paid-media-tracking-specialist.md +71 -0
- turnloom-0.7.0/turnloom/personas/product/product-behavioral-nudge-engine.md +83 -0
- turnloom-0.7.0/turnloom/personas/product/product-dx-engineer.md +332 -0
- turnloom-0.7.0/turnloom/personas/product/product-feedback-synthesizer.md +119 -0
- turnloom-0.7.0/turnloom/personas/product/product-manager.md +469 -0
- turnloom-0.7.0/turnloom/personas/product/product-sprint-prioritizer.md +154 -0
- turnloom-0.7.0/turnloom/personas/product/product-trend-researcher.md +159 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-experiment-tracker.md +198 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-jira-workflow-steward.md +233 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-meeting-notes-specialist.md +95 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-project-shepherd.md +194 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-studio-operations.md +200 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-management-studio-producer.md +203 -0
- turnloom-0.7.0/turnloom/personas/project-management/project-manager-senior.md +135 -0
- turnloom-0.7.0/turnloom/personas/research/research-synthesist.md +136 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-account-strategist.md +227 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-coach.md +271 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-deal-strategist.md +180 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-discovery-coach.md +225 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-engineer.md +182 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-offer-lead-gen-strategist.md +257 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-outbound-strategist.md +201 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-pipeline-analyst.md +267 -0
- turnloom-0.7.0/turnloom/personas/sales/sales-proposal-strategist.md +217 -0
- turnloom-0.7.0/turnloom/personas/security/security-ai-generated-code-auditor.md +207 -0
- turnloom-0.7.0/turnloom/personas/security/security-appsec-engineer.md +536 -0
- turnloom-0.7.0/turnloom/personas/security/security-architect.md +307 -0
- turnloom-0.7.0/turnloom/personas/security/security-blockchain-security-auditor.md +482 -0
- turnloom-0.7.0/turnloom/personas/security/security-cloud-security-architect.md +576 -0
- turnloom-0.7.0/turnloom/personas/security/security-compliance-auditor.md +158 -0
- turnloom-0.7.0/turnloom/personas/security/security-incident-responder.md +450 -0
- turnloom-0.7.0/turnloom/personas/security/security-penetration-tester.md +399 -0
- turnloom-0.7.0/turnloom/personas/security/security-secrets-credential-engineer.md +189 -0
- turnloom-0.7.0/turnloom/personas/security/security-senior-secops.md +771 -0
- turnloom-0.7.0/turnloom/personas/security/security-threat-detection-engineer.md +553 -0
- turnloom-0.7.0/turnloom/personas/security/security-threat-intelligence-analyst.md +661 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/macos-spatial-metal-engineer.md +337 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/terminal-integration-specialist.md +70 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/visionos-spatial-engineer.md +54 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/xr-cockpit-interaction-specialist.md +32 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/xr-immersive-developer.md +32 -0
- turnloom-0.7.0/turnloom/personas/spatial-computing/xr-interface-architect.md +32 -0
- turnloom-0.7.0/turnloom/personas/specialized/accounts-payable-agent.md +205 -0
- turnloom-0.7.0/turnloom/personas/specialized/agentic-identity-trust.md +394 -0
- turnloom-0.7.0/turnloom/personas/specialized/agents-orchestrator.md +367 -0
- turnloom-0.7.0/turnloom/personas/specialized/automation-governance-architect.md +216 -0
- turnloom-0.7.0/turnloom/personas/specialized/business-strategist.md +488 -0
- turnloom-0.7.0/turnloom/personas/specialized/change-management-consultant.md +497 -0
- turnloom-0.7.0/turnloom/personas/specialized/chief-financial-officer.md +388 -0
- turnloom-0.7.0/turnloom/personas/specialized/corporate-training-designer.md +192 -0
- turnloom-0.7.0/turnloom/personas/specialized/customer-service.md +398 -0
- turnloom-0.7.0/turnloom/personas/specialized/customer-success-manager.md +460 -0
- turnloom-0.7.0/turnloom/personas/specialized/data-consolidation-agent.md +60 -0
- turnloom-0.7.0/turnloom/personas/specialized/data-privacy-officer.md +412 -0
- turnloom-0.7.0/turnloom/personas/specialized/esg-sustainability-officer.md +396 -0
- turnloom-0.7.0/turnloom/personas/specialized/government-digital-presales-consultant.md +363 -0
- turnloom-0.7.0/turnloom/personas/specialized/grant-writer.md +511 -0
- turnloom-0.7.0/turnloom/personas/specialized/healthcare-aging-parent-care-companion.md +414 -0
- turnloom-0.7.0/turnloom/personas/specialized/healthcare-customer-service.md +389 -0
- turnloom-0.7.0/turnloom/personas/specialized/healthcare-marketing-compliance.md +395 -0
- turnloom-0.7.0/turnloom/personas/specialized/hospitality-guest-services.md +603 -0
- turnloom-0.7.0/turnloom/personas/specialized/hr-onboarding.md +451 -0
- turnloom-0.7.0/turnloom/personas/specialized/identity-graph-operator.md +303 -0
- turnloom-0.7.0/turnloom/personas/specialized/language-translator.md +264 -0
- turnloom-0.7.0/turnloom/personas/specialized/legal-billing-time-tracking.md +569 -0
- turnloom-0.7.0/turnloom/personas/specialized/legal-client-intake.md +492 -0
- turnloom-0.7.0/turnloom/personas/specialized/legal-document-review.md +454 -0
- turnloom-0.7.0/turnloom/personas/specialized/loan-officer-assistant.md +555 -0
- turnloom-0.7.0/turnloom/personas/specialized/lsp-index-engineer.md +320 -0
- turnloom-0.7.0/turnloom/personas/specialized/ma-integration-manager.md +427 -0
- turnloom-0.7.0/turnloom/personas/specialized/medical-billing-coding-specialist.md +491 -0
- turnloom-0.7.0/turnloom/personas/specialized/operations-manager.md +399 -0
- turnloom-0.7.0/turnloom/personas/specialized/organizational-psychologist.md +391 -0
- turnloom-0.7.0/turnloom/personas/specialized/personal-growth-mentor.md +159 -0
- turnloom-0.7.0/turnloom/personas/specialized/real-estate-buyer-seller.md +596 -0
- turnloom-0.7.0/turnloom/personas/specialized/recruitment-specialist.md +515 -0
- turnloom-0.7.0/turnloom/personas/specialized/report-distribution-agent.md +65 -0
- turnloom-0.7.0/turnloom/personas/specialized/resume-tailor.md +230 -0
- turnloom-0.7.0/turnloom/personas/specialized/retail-customer-returns.md +566 -0
- turnloom-0.7.0/turnloom/personas/specialized/sales-data-extraction-agent.md +67 -0
- turnloom-0.7.0/turnloom/personas/specialized/sales-outreach.md +425 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-chief-of-staff.md +279 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-civil-engineer.md +356 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-codebase-archaeologist.md +341 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-cultural-intelligence-strategist.md +88 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-developer-advocate.md +317 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-document-generator.md +55 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-fedramp-rmf-compliance.md +378 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-focus-music-architect.md +175 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-french-consulting-market.md +194 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-korean-business-navigator.md +216 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-master-plan-architect.md +157 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-mcp-builder.md +260 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-model-qa.md +528 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-pricing-analyst.md +243 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-salesforce-architect.md +182 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-strategy-duel-agent.md +130 -0
- turnloom-0.7.0/turnloom/personas/specialized/specialized-workflow-architect.md +597 -0
- turnloom-0.7.0/turnloom/personas/specialized/study-abroad-advisor.md +282 -0
- turnloom-0.7.0/turnloom/personas/specialized/supply-chain-strategist.md +591 -0
- turnloom-0.7.0/turnloom/personas/specialized/zk-steward.md +211 -0
- turnloom-0.7.0/turnloom/personas/support/support-analytics-reporter.md +387 -0
- turnloom-0.7.0/turnloom/personas/support/support-executive-summary-generator.md +212 -0
- turnloom-0.7.0/turnloom/personas/support/support-finance-tracker.md +480 -0
- turnloom-0.7.0/turnloom/personas/support/support-infrastructure-maintainer.md +628 -0
- turnloom-0.7.0/turnloom/personas/support/support-legal-compliance-checker.md +591 -0
- turnloom-0.7.0/turnloom/personas/support/support-support-responder.md +607 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-accessibility-auditor.md +327 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-api-tester.md +334 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-evidence-collector.md +210 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-performance-benchmarker.md +285 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-reality-checker.md +249 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-test-automation-engineer.md +196 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-test-results-analyzer.md +330 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-tool-evaluator.md +416 -0
- turnloom-0.7.0/turnloom/personas/testing/testing-workflow-optimizer.md +488 -0
- turnloom-0.7.0/turnloom/providers.py +403 -0
- turnloom-0.7.0/turnloom/proxy.py +252 -0
- turnloom-0.7.0/turnloom/roster.py +92 -0
- turnloom-0.7.0/turnloom/server.py +149 -0
- turnloom-0.7.0/turnloom/studio.py +1342 -0
- turnloom-0.7.0/turnloom/studio_assets/THIRD-PARTY.txt +1891 -0
- turnloom-0.7.0/turnloom/studio_assets/icon.ico +0 -0
- turnloom-0.7.0/turnloom/studio_assets/icon.png +0 -0
- turnloom-0.7.0/turnloom/studio_assets/icon.svg +1 -0
- turnloom-0.7.0/turnloom/studio_assets/index.html +2 -0
- turnloom-0.7.0/turnloom/studio_assets/studio.css +1 -0
- turnloom-0.7.0/turnloom/studio_assets/studio.js +110 -0
- turnloom-0.7.0/turnloom/team.py +103 -0
- turnloom-0.7.0/turnloom/tools.py +479 -0
- turnloom-0.7.0/turnloom/unwind_stdio.py +44 -0
- turnloom-0.7.0/turnloom.egg-info/PKG-INFO +209 -0
- turnloom-0.7.0/turnloom.egg-info/SOURCES.txt +409 -0
- turnloom-0.7.0/turnloom.egg-info/dependency_links.txt +1 -0
- turnloom-0.7.0/turnloom.egg-info/entry_points.txt +9 -0
- turnloom-0.7.0/turnloom.egg-info/requires.txt +45 -0
- turnloom-0.7.0/turnloom.egg-info/top_level.txt +1 -0
turnloom-0.7.0/AGENTS.md
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Working on Turnloom
|
|
2
|
+
|
|
3
|
+
Turnloom is a small coding agent: one loop, a context store and a handful of tools. Keep it small. A change that adds a dependency to the core or a second way to do something needs a strong reason.
|
|
4
|
+
|
|
5
|
+
## Layout
|
|
6
|
+
|
|
7
|
+
| Path | Role |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| `turnloom/agent.py` | The loop: model requests, streaming, retries, tool dispatch, context fitting, the transcript |
|
|
10
|
+
| `turnloom/context.py` | `Observations`: fold, archive, recall |
|
|
11
|
+
| `turnloom/tools.py` | Workspace file tools, path confinement, edits and undo |
|
|
12
|
+
| `turnloom/cli.py` | The `turnloom` command, approvals, sessions, receipts |
|
|
13
|
+
| `turnloom/studio.py` | The local web server behind Studio |
|
|
14
|
+
| `turnloom/desktop.py`, `packaging/` | The native window and the standalone app build |
|
|
15
|
+
| `turnloom/providers.py`, `openrouter.py`, `gateway.py` | Provider presets, model discovery, credentials, sign-in, LiteLLM routes |
|
|
16
|
+
| `turnloom/extensions.py`, `server.py`, `acp.py` | Skills and the MCP client; Turnloom as an MCP server; Turnloom as an ACP agent |
|
|
17
|
+
| `turnloom/guard.py` | The Provio policy gate |
|
|
18
|
+
| `turnloom/meter.py`, `proxy.py` | Token counting and the usage ledger; the folding proxy for other harnesses |
|
|
19
|
+
| `turnloom/roster.py`, `personas/` | Native and vendored personas. `scripts/sync_personas.py` refreshes the vendored set |
|
|
20
|
+
| `turnloom/evaluate.py`, `compare.py`, `team.py`, `atif.py` | Evaluation runner, comparison, staged runs, ATIF export |
|
|
21
|
+
| `integrations/` | The Harbor adapter and patches offered upstream to Provio and Unwind |
|
|
22
|
+
| `studio/` | Studio's React source. `npm run build` writes `turnloom/studio_assets/` |
|
|
23
|
+
| `tests/` | `unittest` suites. No network; the model is always scripted |
|
|
24
|
+
|
|
25
|
+
## Commands
|
|
26
|
+
|
|
27
|
+
```sh
|
|
28
|
+
python -m pip install -e ".[full]" # add ,documents for the VerifyDoc and Unwind tests
|
|
29
|
+
python -m unittest discover -s tests # the whole suite, about a minute
|
|
30
|
+
python -m unittest tests.test_agent -v # one module
|
|
31
|
+
ruff check .
|
|
32
|
+
cd studio && npm ci && npm run build # after changing anything under studio/
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Rules
|
|
36
|
+
|
|
37
|
+
- The core imports only the standard library and `keyring`. Optional features import their package lazily and raise a `ValueError` naming the extra when it is missing.
|
|
38
|
+
- Every behavior change comes with a test that fails without it. Tests script the model by patching `turnloom.agent.api_request` or by running a local HTTP server; they never call a real provider.
|
|
39
|
+
- Anything that touches a path goes through `Workspace.resolve`. Do not join user or model input to the workspace root yourself.
|
|
40
|
+
- Anything that runs a command goes through `agent.execute`, so timeouts and stops end the whole process tree.
|
|
41
|
+
- Commands, edits and MCP calls pass the policy gate and then the approval gate (`agent.gated`, `agent.permitted`). A new tool with side effects must too.
|
|
42
|
+
- Text shown to people is plain and specific: say what happened and what to do next. No tracebacks for expected failures.
|
|
43
|
+
- Windows is a first-class platform. Do not assume `/bin/sh`, forward slashes in output, or UTF-8 consoles.
|
|
44
|
+
- Commit the rebuilt `turnloom/studio_assets/` together with any change under `studio/`. Continuous integration rebuilds and compares.
|
|
45
|
+
- Personas under `turnloom/personas/` are vendored. Change them upstream and refresh with `scripts/sync_personas.py`, which keeps the license and records the commit. Keep `turnloom/data/providers.json` attributable to Models.dev.
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Notable changes to Turnloom. Versions follow [Semantic Versioning](https://semver.org); before 1.0 a minor version may change behavior.
|
|
4
|
+
|
|
5
|
+
## 0.7.0
|
|
6
|
+
|
|
7
|
+
The first public release. The agent gains real file tools, streaming, sessions that survive the process, and reversible edits. Studio is redesigned and rebuilt on those. Turnloom can now be driven from editors and from other agents.
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **File tools in every session.** `list_files`, `read_file`, `search_files`, `edit_file` and `write_file` are confined to the workspace. Edits show a diff for approval, keep line endings, and are written atomically. Before this release the terminal agent could only use the shell.
|
|
12
|
+
- **Undo for edits.** `turnloom undo`, `/undo` in chat and Studio restore the files a turn edited. A file changed since is kept and reported.
|
|
13
|
+
- **Streaming.** Replies appear as they are written in the terminal, in Studio and in editors, with tool activity shown while it runs.
|
|
14
|
+
- **Sessions.** `turnloom sessions` lists them, `--resume` continues one with its tool results intact, and Studio can start, list and resume sessions.
|
|
15
|
+
- **Approval modes.** `--auto-edit`, `--read-only`, `--allow PATTERN`, and an "always" answer at the prompt. Studio has the same choices.
|
|
16
|
+
- **Editors.** `turnloom acp` serves the Agent Client Protocol, for Zed, JetBrains IDEs and other ACP clients.
|
|
17
|
+
- **Project instructions and skills.** `AGENTS.md` (or `CLAUDE.md`) is read from the workspace root. Skills under `.agents/skills` and `.claude/skills` are offered to the model.
|
|
18
|
+
- **MCP over HTTP.** Server entries may be a streamable HTTP `url` with a `bearer_env`, and process entries may set `env`.
|
|
19
|
+
- **Turnloom as an MCP server for other agents.** `turnloom serve` adds `transcript` and `read_result`, and with `--allow-run` a `run_task` tool.
|
|
20
|
+
- **GitHub Action and container image definition** for unattended runs.
|
|
21
|
+
- `turnloom studio`, `turnloom doctor`, `--max-steps`, `--events`, and chat commands `/diff`, `/undo`, `/new`, `/help`.
|
|
22
|
+
- Studio can create, rename and delete files, shows what a turn edited with a review and a revert, and has light and dark themes.
|
|
23
|
+
- `TURNLOOM_ENDPOINT`, `TURNLOOM_MODEL` and `TURNLOOM_API_KEY`.
|
|
24
|
+
|
|
25
|
+
### Changed
|
|
26
|
+
|
|
27
|
+
- **Commands and edits are declined unless something approves them.** A caller that sets no approval callback must opt in with `auto_approve`. Previously a missing callback meant "approve everything".
|
|
28
|
+
- **The policy gate covers file edits** as `fs.write`, alongside shell commands, reads and MCP calls. Searches return only lines from files the policy allows, delegated tasks through `turnloom serve` are gated, and a rule that asks is put to the operator once, with an edit's diff in view. Studio refuses to run ungated when a policy file exists and Provio is missing.
|
|
29
|
+
- **Programs are never taken from the project folder.** ripgrep, Git, Provio and `taskkill` are resolved from `PATH` and the interpreter's scripts folder only. On Windows a bare program name used to resolve in the current directory first.
|
|
30
|
+
- Directory junctions leading out of the workspace are no longer listed or searched. Read-only sessions no longer offer MCP tools.
|
|
31
|
+
- Studio remembers an enabled MCP server together with its definition and switches it off when the definition changes. Choosing "always" on an edit lasts for the session and is not saved.
|
|
32
|
+
- **Context overflow archives instead of deleting.** Exchanges removed to fit the window stay recoverable through `recall`, and an oversized newest result is shortened in place rather than failing the turn.
|
|
33
|
+
- **Tool results the model has not read are never folded.** A batch of parallel calls used to lose all but its last three results before the model saw them.
|
|
34
|
+
- **Full command output is archived** when the prompt only receives its head and tail.
|
|
35
|
+
- A timeout or a stop ends a command's whole process tree. Stopping a turn interrupts a running command and an in-flight model reply.
|
|
36
|
+
- Chat continues after a failed turn instead of exiting, and Ctrl+C ends the turn rather than the program.
|
|
37
|
+
- Retries honor `Retry-After`, cover dropped connections, and retry a timed-out request once instead of four times.
|
|
38
|
+
- A truncated reply is returned as `partial`. An empty reply is retried once. Limits explain why they stopped the turn.
|
|
39
|
+
- Three identical tool calls in a row end tool use everywhere, not only in Studio. Repeating a check between edits is no longer treated as a loop.
|
|
40
|
+
- `turnloom team` runs without LangGraph installed, and planning and review stages are read-only by construction. Studio's team stages gain a read-only switch.
|
|
41
|
+
- Session traces, the usage ledger and the undo database get a `.gitignore`, so they stay out of the user's repository. `.turnloom/mcp.json` and `.turnloom/personas/` remain visible to Git so a team can share them.
|
|
42
|
+
- **Studio settings moved out of the workspace** into the operator's configuration folder. A `.turnloom/studio.json` shipped in a repository could previously turn on auto-approve or enable MCP servers; that file is no longer read.
|
|
43
|
+
- Studio no longer shows sample data. It keeps the conversation when a turn fails or the persona changes, waits for approvals without a timer, stops by itself when left unused in a browser, and opens without putting its token on a browser's command line. Closing Studio stops a running turn.
|
|
44
|
+
- `turnloom-studio` is a console command, so its help and errors are visible. `turnloom-studio-gui` is the windowless variant. `--no-open` and `--port` support remote shells.
|
|
45
|
+
- The proxy refuses requests that carry a browser `Origin` or a foreign `Host`.
|
|
46
|
+
- Command output is decoded as UTF-8 first. Redirected terminal output is UTF-8 on Windows.
|
|
47
|
+
- The evaluation interval resamples attempts as well as tasks, checks end their process tree at the timeout, and the example manifest is a task that runs.
|
|
48
|
+
- The `desktop` extra no longer installs PyInstaller; `build-app` does. `studio` and `full` are composed from the smaller extras.
|
|
49
|
+
|
|
50
|
+
### Removed
|
|
51
|
+
|
|
52
|
+
- `turnloom demo`, which folded a hard-coded string. `turnloom doctor` is the offline check.
|
|
53
|
+
- Benchmark-specific rules from the default system prompt. `turnloom-agent` and the evaluation runner add them to their own sessions.
|
|
54
|
+
- Thirteen provider presets that need a vendor-specific client or a token exchange.
|
|
55
|
+
- The Cline UI components and the Tailwind-dependent styling in Studio.
|
|
56
|
+
|
|
57
|
+
### Upgrading from 0.6
|
|
58
|
+
|
|
59
|
+
- Scripts that used `turnloom run` without a terminal must pass `--read-only`, `--auto-edit` or `--yes`.
|
|
60
|
+
- `HARNESS_ENDPOINT`, `HARNESS_MODEL` and `HARNESS_API_KEY` still work. Prefer the `TURNLOOM_` names.
|
|
61
|
+
- Code that builds a `Config` directly: `approve` now receives `(kind, detail)`, and unattended callers set `auto_approve=True`. `workspace_tool` is replaced by the built-in file tools.
|
|
62
|
+
- A PyInstaller build installs `.[build-app]` instead of `.[studio,full,desktop]`.
|
|
63
|
+
- Studio settings saved by 0.6 in `.turnloom/studio.json` are not carried over. Set them again once; the old file can be deleted.
|
|
64
|
+
- MCP clients of `turnloom serve`: the tools are now `sessions`, `receipt`, `transcript`, `read_result`, `archive_output`, `recall` and optionally `run_task`.
|
|
65
|
+
|
|
66
|
+
## 0.6.0
|
|
67
|
+
|
|
68
|
+
Tagged on GitHub and not published to a package index.
|
|
69
|
+
|
|
70
|
+
- Studio rebuilt around a view rail and a command palette, opening in a native window through pywebview, with a PyInstaller spec for a standalone app.
|
|
71
|
+
- New Studio views: Changes, Agents (283 vendored Agency Agents personas and a team builder), Cost, Policy, Tools, Documents and Undo ledger.
|
|
72
|
+
- Every model call metered into `.turnloom/usage.jsonl`, with cached input priced at the cache rate and each request's reply limit fitted to the remaining context window.
|
|
73
|
+
- Provio gates shell commands, workspace reads and MCP tool calls when the workspace has a `provio.yaml`, and fails closed.
|
|
74
|
+
- LiteLLM reaches native provider APIs as `litellm:<provider>`.
|
|
75
|
+
- `turnloom proxy` serves an OpenAI-compatible endpoint that folds and meters requests from other harnesses.
|
|
76
|
+
- Folded previews keep their ending, and `recall` can search.
|
|
77
|
+
- A Harbor installed-agent adapter, the headless `turnloom-agent` entry point and ATIF export.
|
|
78
|
+
|
|
79
|
+
## 0.5.0 and earlier
|
|
80
|
+
|
|
81
|
+
Development versions: the terminal agent with shell and recall tools, provider connections with OpenRouter sign-in, MCP stdio servers, Agent Skills loading, the evaluation tools, and the first version of Studio.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Contributing
|
|
2
|
+
|
|
3
|
+
Bug reports with a small reproduction and focused pull requests are welcome. For anything larger than a fix, open an issue first so the direction can be agreed before you write the code. Security problems go through the private channel in [SECURITY.md](SECURITY.md).
|
|
4
|
+
|
|
5
|
+
## Set up
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
git clone https://github.com/bhaskargurram-ai/turnloom
|
|
9
|
+
cd turnloom
|
|
10
|
+
python -m venv .venv
|
|
11
|
+
.venv/bin/python -m pip install -e ".[full]" # Windows: .venv\Scripts\python
|
|
12
|
+
.venv/bin/python -m unittest discover -s tests
|
|
13
|
+
ruff check .
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
The suite needs no network and no model: tests script the model's replies. [AGENTS.md](AGENTS.md) maps the code and lists the rules a change has to follow; it is written for coding agents and is the quickest orientation for people too.
|
|
17
|
+
|
|
18
|
+
## Studio
|
|
19
|
+
|
|
20
|
+
The browser interface lives in `studio/` and is bundled into `turnloom/studio_assets/`, which the Python package ships so users never need Node.
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
cd studio
|
|
24
|
+
npm ci
|
|
25
|
+
npm run build # writes ../turnloom/studio_assets
|
|
26
|
+
npx playwright install chromium # once
|
|
27
|
+
PYTHON=../.venv/bin/python npm run test:browser
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Commit the rebuilt assets with your source change. The browser test drives a real Studio server with a scripted model through every view. Set `BROWSER_CHANNEL=chrome` to use an installed Chrome. The Documents and Policy steps run when the `documents` and `guard` extras are installed and are skipped otherwise.
|
|
31
|
+
|
|
32
|
+
The standalone desktop app is built with `packaging/build.ps1` or the steps in [docs/desktop.md](docs/desktop.md).
|
|
33
|
+
|
|
34
|
+
## What a pull request needs
|
|
35
|
+
|
|
36
|
+
- A test that fails without the change.
|
|
37
|
+
- For changes to prompts, folding or cost accounting: the control settings, model, sample size and the measured difference. `turnloom-eval` and `turnloom-compare` exist for this; see [docs/experiments.md](docs/experiments.md).
|
|
38
|
+
- Documentation updated in the same pull request when behavior or a flag changes, and a line in [CHANGELOG.md](CHANGELOG.md).
|
|
39
|
+
- No credentials or private task data in any trace you attach.
|
|
40
|
+
|
|
41
|
+
## Releasing
|
|
42
|
+
|
|
43
|
+
1. Update `__version__` in `turnloom/__init__.py` and the changelog.
|
|
44
|
+
2. Tag `vX.Y.Z` and push the tag.
|
|
45
|
+
3. The release workflow builds the wheel and source archive, installs the wheel in a clean environment, attaches the files to a GitHub release and pushes the container image to GHCR.
|
|
46
|
+
4. Publish to PyPI. With trusted publishing configured (see the comment in `.github/workflows/release.yml`) the workflow does it. Otherwise download the release files and upload exactly those: `gh release download vX.Y.Z -p "turnloom-*" -D dist && twine upload dist/*`.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# An isolated place to run Turnloom unattended: the agent sees only the project you mount at /workspace.
|
|
2
|
+
FROM python:3.12-slim
|
|
3
|
+
|
|
4
|
+
RUN apt-get update \
|
|
5
|
+
&& apt-get install -y --no-install-recommends git ripgrep ca-certificates \
|
|
6
|
+
&& rm -rf /var/lib/apt/lists/*
|
|
7
|
+
|
|
8
|
+
WORKDIR /opt/turnloom
|
|
9
|
+
COPY pyproject.toml README.md LICENSE ./
|
|
10
|
+
COPY turnloom ./turnloom
|
|
11
|
+
RUN pip install --no-cache-dir ".[mcp,skills]" \
|
|
12
|
+
&& useradd --create-home --uid 1000 agent \
|
|
13
|
+
&& mkdir /workspace && chown agent:agent /workspace
|
|
14
|
+
|
|
15
|
+
USER agent
|
|
16
|
+
WORKDIR /workspace
|
|
17
|
+
# The image has no credential store; pass TURNLOOM_ENDPOINT, TURNLOOM_MODEL and TURNLOOM_API_KEY.
|
|
18
|
+
ENV PYTHONUNBUFFERED=1 GIT_CONFIG_COUNT=1 GIT_CONFIG_KEY_0=safe.directory GIT_CONFIG_VALUE_0=/workspace
|
|
19
|
+
ENTRYPOINT ["turnloom"]
|
|
20
|
+
CMD ["--help"]
|
turnloom-0.7.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Turnloom contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
include LICENSE CHANGELOG.md SECURITY.md CONTRIBUTING.md AGENTS.md action.yml Dockerfile
|
|
2
|
+
include *.cmd
|
|
3
|
+
graft docs
|
|
4
|
+
graft examples
|
|
5
|
+
graft integrations
|
|
6
|
+
graft packaging
|
|
7
|
+
graft scripts
|
|
8
|
+
graft tests
|
|
9
|
+
graft studio
|
|
10
|
+
prune studio/node_modules
|
|
11
|
+
prune examples/toolkit/node_modules
|
|
12
|
+
global-exclude __pycache__ *.py[cod] .DS_Store
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
@echo off
|
|
2
|
+
setlocal
|
|
3
|
+
cd /d "%~dp0"
|
|
4
|
+
set "PY=.venv\Scripts\python.exe"
|
|
5
|
+
if exist "%PY%" goto :check
|
|
6
|
+
set "BOOT=py -3"
|
|
7
|
+
where py >nul 2>nul
|
|
8
|
+
if errorlevel 1 set "BOOT=python"
|
|
9
|
+
%BOOT% -c "import sys; sys.exit(sys.version_info < (3, 11))" >nul 2>nul
|
|
10
|
+
if errorlevel 1 goto :nopython
|
|
11
|
+
%BOOT% -m venv .venv
|
|
12
|
+
if errorlevel 1 goto :failed
|
|
13
|
+
:check
|
|
14
|
+
rem Reinstall when the checkout is newer than what the environment holds.
|
|
15
|
+
"%PY%" -I -c "import sys, turnloom; from importlib.metadata import version; sys.exit(version('turnloom') != turnloom.__version__)" >nul 2>nul
|
|
16
|
+
if not errorlevel 1 goto :launch
|
|
17
|
+
echo Setting up Turnloom Studio. This takes a minute the first time.
|
|
18
|
+
"%PY%" -m pip install --disable-pip-version-check -e ".[studio]"
|
|
19
|
+
if errorlevel 1 goto :failed
|
|
20
|
+
:launch
|
|
21
|
+
start "" ".venv\Scripts\pythonw.exe" -I -m turnloom.studio %*
|
|
22
|
+
exit /b 0
|
|
23
|
+
:nopython
|
|
24
|
+
echo Turnloom needs Python 3.11 or newer. Install it from https://www.python.org/downloads/ and run this file again.
|
|
25
|
+
pause
|
|
26
|
+
exit /b 1
|
|
27
|
+
:failed
|
|
28
|
+
echo Studio setup failed. Check the Python or installation error above.
|
|
29
|
+
pause
|
|
30
|
+
exit /b 1
|
turnloom-0.7.0/PKG-INFO
ADDED
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: turnloom
|
|
3
|
+
Version: 0.7.0
|
|
4
|
+
Summary: A coding agent whose context you can inspect: folded tool output stays recoverable, edits are reviewable and reversible, and every call is metered
|
|
5
|
+
Author: Turnloom contributors
|
|
6
|
+
License-Expression: MIT AND ISC
|
|
7
|
+
Project-URL: Homepage, https://github.com/bhaskargurram-ai/turnloom
|
|
8
|
+
Project-URL: Repository, https://github.com/bhaskargurram-ai/turnloom
|
|
9
|
+
Project-URL: Documentation, https://github.com/bhaskargurram-ai/turnloom/tree/main/docs
|
|
10
|
+
Project-URL: Changelog, https://github.com/bhaskargurram-ai/turnloom/blob/main/CHANGELOG.md
|
|
11
|
+
Project-URL: Issues, https://github.com/bhaskargurram-ai/turnloom/issues
|
|
12
|
+
Keywords: coding-agent,llm,agent,cli,mcp,agent-client-protocol,context-management,developer-tools,openrouter,ollama
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Environment :: Console
|
|
15
|
+
Classifier: Environment :: Web Environment
|
|
16
|
+
Classifier: Intended Audience :: Developers
|
|
17
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
18
|
+
Classifier: Operating System :: MacOS
|
|
19
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
20
|
+
Classifier: Programming Language :: Python :: 3
|
|
21
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
26
|
+
Classifier: Topic :: Software Development
|
|
27
|
+
Classifier: Topic :: Software Development :: Code Generators
|
|
28
|
+
Requires-Python: >=3.11
|
|
29
|
+
Description-Content-Type: text/markdown
|
|
30
|
+
License-File: LICENSE
|
|
31
|
+
License-File: turnloom/personas/LICENSE
|
|
32
|
+
License-File: turnloom/data/LICENSE.models-dev
|
|
33
|
+
License-File: turnloom/studio_assets/THIRD-PARTY.txt
|
|
34
|
+
Requires-Dist: keyring<27,>=25
|
|
35
|
+
Provides-Extra: mcp
|
|
36
|
+
Requires-Dist: mcp<2,>=1.30; extra == "mcp"
|
|
37
|
+
Provides-Extra: skills
|
|
38
|
+
Requires-Dist: PyYAML<7,>=6; extra == "skills"
|
|
39
|
+
Provides-Extra: search
|
|
40
|
+
Requires-Dist: ripgrep<16,>=14.1; extra == "search"
|
|
41
|
+
Provides-Extra: tokens
|
|
42
|
+
Requires-Dist: tiktoken<1,>=0.9; extra == "tokens"
|
|
43
|
+
Provides-Extra: llm
|
|
44
|
+
Requires-Dist: litellm<2,>=1.80; extra == "llm"
|
|
45
|
+
Provides-Extra: guard
|
|
46
|
+
Requires-Dist: provio-sdk<0.2,>=0.1.5; extra == "guard"
|
|
47
|
+
Provides-Extra: team
|
|
48
|
+
Requires-Dist: langgraph<2,>=1.2; extra == "team"
|
|
49
|
+
Provides-Extra: desktop
|
|
50
|
+
Requires-Dist: pywebview<7,>=6; extra == "desktop"
|
|
51
|
+
Provides-Extra: acp
|
|
52
|
+
Requires-Dist: agent-client-protocol<2,>=1.0; extra == "acp"
|
|
53
|
+
Provides-Extra: documents
|
|
54
|
+
Requires-Dist: rollback-mcp==0.2.0; extra == "documents"
|
|
55
|
+
Requires-Dist: verifydoc[mcp]==0.10.0; extra == "documents"
|
|
56
|
+
Requires-Dist: mcp<2,>=1.30; extra == "documents"
|
|
57
|
+
Provides-Extra: studio
|
|
58
|
+
Requires-Dist: turnloom[desktop,documents,guard,search,tokens]; extra == "studio"
|
|
59
|
+
Provides-Extra: full
|
|
60
|
+
Requires-Dist: turnloom[acp,guard,llm,mcp,search,skills,team,tokens]; extra == "full"
|
|
61
|
+
Requires-Dist: mcp-server-time>=2026.10.10; extra == "full"
|
|
62
|
+
Requires-Dist: mcp-server-git>=2026.10.10; extra == "full"
|
|
63
|
+
Provides-Extra: build-app
|
|
64
|
+
Requires-Dist: turnloom[full,studio]; extra == "build-app"
|
|
65
|
+
Requires-Dist: pyinstaller<7,>=6.16; extra == "build-app"
|
|
66
|
+
Dynamic: license-file
|
|
67
|
+
|
|
68
|
+

|
|
69
|
+
|
|
70
|
+
Turnloom is a coding agent for your terminal and desktop that shows you what it keeps in context and what each call costs. It reads and edits files, runs commands with your approval, and folds older tool output out of the prompt into a local archive that you and the model can read back at any time. Every edit is shown as a diff before it lands and can be undone afterwards. Every model call is metered.
|
|
71
|
+
|
|
72
|
+
It works with any OpenAI-compatible endpoint: hosted providers, OpenRouter, or a model on your own machine through Ollama, LM Studio, vLLM or llama.cpp. LiteLLM adds Anthropic, Bedrock, Vertex AI and Azure.
|
|
73
|
+
|
|
74
|
+
[Install](#install) · [Studio](#studio) · [Terminal](#terminal) · [Staying in control](#staying-in-control) · [How context works](#how-context-works) · [Works with](#works-with) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
|
|
75
|
+
|
|
76
|
+
## Install
|
|
77
|
+
|
|
78
|
+
Turnloom needs Python 3.11 or newer. The core has one dependency.
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
pipx install "git+https://github.com/bhaskargurram-ai/turnloom"
|
|
82
|
+
turnloom connect # pick a provider and a model
|
|
83
|
+
turnloom chat # start working in the current directory
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
`uv tool install "git+https://github.com/bhaskargurram-ai/turnloom"` and `pip install` work the same way. Each [release](https://github.com/bhaskargurram-ai/turnloom/releases) also carries a wheel. On Windows you can instead clone the repository and double-click **Open Turnloom Studio.cmd**, which creates its own environment.
|
|
87
|
+
|
|
88
|
+
`turnloom connect` lists providers and their models. Choose OpenRouter to sign in through your browser, choose Ollama or LM Studio to use a local model, or pick any other provider and paste its key once. Keys go to your operating system's credential store, never to a file. `turnloom doctor` checks the setup. [Provider guide](docs/providers.md)
|
|
89
|
+
|
|
90
|
+
## Studio
|
|
91
|
+
|
|
92
|
+
```sh
|
|
93
|
+
pipx install "turnloom[studio] @ git+https://github.com/bhaskargurram-ai/turnloom"
|
|
94
|
+
turnloom studio
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Studio is a workbench that opens in its own window, or in a browser tab with `--browser`. The base install runs it too; the `studio` extra adds the native window, the policy gate, exact token counts and document tools.
|
|
98
|
+
|
|
99
|
+

|
|
100
|
+
|
|
101
|
+
| View | Use it to |
|
|
102
|
+
| --- | --- |
|
|
103
|
+
| **Code** | Edit files beside the agent's work log. The reply streams in, each tool call shows what ran, and edits arrive as diffs to approve, reject, or allow for the session. After a turn, review every file it touched and revert the turn's edits. |
|
|
104
|
+
| **Context Loom** | See each tool result's original size and what the prompt still carries. Open any folded result to read the archived original without spending a model call. |
|
|
105
|
+
| **Changes** | Compare the working tree with the last commit. |
|
|
106
|
+
| **Agents** | Pick from 285 personas, or line several up as a team that plans, builds and reviews in stages. |
|
|
107
|
+
| **Cost** | See tokens and estimated cost per call, how full the context window is and what fills it, and set a budget per turn. |
|
|
108
|
+
| **Policy** | Gate every tool call with Provio: what was allowed, asked and denied, a tester for a command or path, and the ledger's integrity. |
|
|
109
|
+
| **Tools** | Turn MCP servers on for the agent and inspect the tools each one offers. |
|
|
110
|
+
| **Documents** | Extract fields from a document with VerifyDoc and see each value's confidence and where it was read. |
|
|
111
|
+
| **Undo ledger** | Review what Unwind recorded for MCP calls, set checkpoints and take actions back. |
|
|
112
|
+
|
|
113
|
+
Sessions are saved in the workspace; start a new one or resume an earlier one. Press **Ctrl+K** for the command palette.
|
|
114
|
+
|
|
115
|
+
Studio listens on 127.0.0.1 only and requires a per-launch token on every request. Details are in [SECURITY.md](SECURITY.md). To ship it as a standalone app folder, see [Desktop app](docs/desktop.md).
|
|
116
|
+
|
|
117
|
+
## Terminal
|
|
118
|
+
|
|
119
|
+
| Command | What it does |
|
|
120
|
+
| --- | --- |
|
|
121
|
+
| `turnloom chat` | Work across several turns. `/diff`, `/undo`, `/new` and `/help` are available inside. |
|
|
122
|
+
| `turnloom run "Fix the failing parser test"` | Run one task and exit with status 0 when it completes. |
|
|
123
|
+
| `turnloom run "Review the staged diff" --persona reviewer --read-only` | Explore and report without edits or commands. |
|
|
124
|
+
| `turnloom chat --resume` | Continue the most recent session. `--resume ID` picks one. |
|
|
125
|
+
| `turnloom sessions` | List saved sessions in this workspace. |
|
|
126
|
+
| `turnloom undo` | Restore the files edited by the last turn of a session. |
|
|
127
|
+
| `turnloom team "Add input validation"` | Plan, build and review in three stages that share one budget. Planning and review cannot edit. |
|
|
128
|
+
| `turnloom personas --search security` | Browse personas. Use one with `--persona ID`. |
|
|
129
|
+
| `turnloom proxy` | Fold and meter requests from another harness. |
|
|
130
|
+
| `turnloom replay PATH`, `turnloom atif TRANSCRIPT OUTPUT` | Print a saved session offline, or export it as an ATIF trajectory. |
|
|
131
|
+
| `turnloom studio`, `turnloom doctor` | Open the workbench. Report version, connection, optional features and workspace state. |
|
|
132
|
+
|
|
133
|
+
For scripts and CI, `--json` prints one result object and `--events` prints each session event as a JSON line while it happens.
|
|
134
|
+
|
|
135
|
+
## Staying in control
|
|
136
|
+
|
|
137
|
+
Turnloom asks before it runs a command, edits a file or calls an MCP tool. Reading and searching files inside the workspace does not need approval, and those reads are sent to the model you connected.
|
|
138
|
+
|
|
139
|
+
| Mode | Flag | Behavior |
|
|
140
|
+
| --- | --- | --- |
|
|
141
|
+
| Ask (default) | none | Approve each command and edit. Answer `a` to allow all later edits, or that exact command, for the session. |
|
|
142
|
+
| Auto-edit | `--auto-edit` | Edits apply without asking. Commands still ask. |
|
|
143
|
+
| Allowlist | `--allow "pytest*"` | Simple commands matching the pattern run without asking. A pattern never covers a command that chains, pipes, redirects or substitutes. |
|
|
144
|
+
| Read-only | `--read-only` | No edits and no shell. The agent can only read, search and answer. |
|
|
145
|
+
| Unattended | `--yes` | Everything is approved. Use it only inside a container or a disposable checkout. |
|
|
146
|
+
|
|
147
|
+
Other limits you can set per task: `--budget 0.25` stops before the estimated cost passes that amount, `--max-steps` caps model calls (100 by default), and `--deadline` caps wall time. At the step limit the agent spends its last call writing up what it found. Three identical tool calls in a row end tool use the same way. The other limits stop the turn and say why.
|
|
148
|
+
|
|
149
|
+
Commands run with your user's permissions. Model API keys are removed from the environment that commands see. Files that usually hold secrets, such as `.env`, private keys and credential files, are closed to the file tools.
|
|
150
|
+
|
|
151
|
+
### A policy under the agent
|
|
152
|
+
|
|
153
|
+
[Provio](https://github.com/writ-agent/provio) checks each tool call against a `provio.yaml` in your repository before it runs, and writes every decision to a hash-chained ledger at `.provio/ledger.jsonl`. Turnloom turns the gate on whenever the workspace has that file and the `guard` extra is installed. Create a starter policy from Studio's Policy view or with `provio init`.
|
|
154
|
+
|
|
155
|
+
| Verdict | What happens |
|
|
156
|
+
| --- | --- |
|
|
157
|
+
| deny | The tool does not run. The model reads the rule and its reason, so it can correct course. |
|
|
158
|
+
| ask | You decide, and the approval shows the rule that asked. With `--yes` there is nobody to ask, so the call is refused. |
|
|
159
|
+
| allow | The call runs. By default you still confirm each call; in Studio choose the policy mode to be asked only when a rule says ask. |
|
|
160
|
+
| redact | The call runs and the model receives Provio's redacted output. |
|
|
161
|
+
|
|
162
|
+
The gate covers shell commands, file reads, file edits and MCP tool calls, and it fails closed: if Provio cannot answer, the tool does not run. Pass `--no-gate` to run once without the policy.
|
|
163
|
+
|
|
164
|
+
## How context works
|
|
165
|
+
|
|
166
|
+
Long sessions fill the prompt with old tool output. Turnloom handles that without a summarizing model call:
|
|
167
|
+
|
|
168
|
+
1. **Fold.** The three most recent tool results stay whole. Older results longer than 800 characters are replaced in the prompt by a short preview of their start and end and a reference. Results the model has not read yet are never folded.
|
|
169
|
+
2. **Archive.** The full text stays in the session's archive. When a command prints more than fits, the prompt gets the head and tail and the archive keeps the rest.
|
|
170
|
+
3. **Recall.** The model calls `recall` with a reference to read a slice or search inside an archived result. You can open the same reference in Studio.
|
|
171
|
+
4. **Overflow.** If the conversation still outgrows the model's window, the oldest exchanges move to the archive as a unit and their references are listed for the model. Nothing is dropped without a way back.
|
|
172
|
+
|
|
173
|
+
The transcript of every session is a JSON Lines file under `.turnloom/` in the workspace, with a `.gitignore` that keeps traces out of version control. `--resume` rebuilds the conversation and its archive from that file. Studio and the proxy also append every model call to `.turnloom/usage.jsonl`.
|
|
174
|
+
|
|
175
|
+
Use `--no-fold` to compare a run with folding against one without. The receipt reports folded characters, input and output tokens, and cached tokens when the provider reports them; cached input is priced at the provider's cache rate when it lists one. Folding rewrites earlier messages, so on providers with prompt caching it trades some cache hits for a smaller prompt. Measure on your own tasks before relying on it. [Design notes](docs/design.md) · [Measuring it yourself](docs/experiments.md)
|
|
176
|
+
|
|
177
|
+
## Works with
|
|
178
|
+
|
|
179
|
+
- **Project instructions.** `AGENTS.md` at the workspace root is added to the agent's instructions, with `CLAUDE.md` as a fallback.
|
|
180
|
+
- **Agent Skills.** Skills checked into `.agents/skills` or `.claude/skills` are listed for the model, which reads one when a task calls for it.
|
|
181
|
+
- **Personas.** Builder and Debugger are Turnloom's own. The other 283 come from [Agency Agents](https://github.com/msitarzewski/agency-agents), vendored at commit `8ae6164`. Add your own as Markdown files in `.turnloom/personas/`.
|
|
182
|
+
- **MCP servers.** `--mcp servers.json`, or `.turnloom/mcp.json` in Studio, connects stdio and streamable HTTP servers. The model searches a server's tools and calls them with your approval.
|
|
183
|
+
- **Other agents, as a server.** `turnloom serve` is an MCP server: session receipts, archived tool results, a place to park long output, and with `--allow-run` task delegation to Turnloom.
|
|
184
|
+
- **Other harnesses, as a layer.** `turnloom proxy` serves an OpenAI-compatible endpoint that folds and meters another harness's requests to your connected model.
|
|
185
|
+
- **Native provider APIs.** With the `llm` extra, `turnloom connect litellm:anthropic` and its siblings reach providers that are not OpenAI-compatible, through [LiteLLM](https://github.com/BerriAI/litellm).
|
|
186
|
+
- **CI and containers.** The repository is a GitHub Action (`uses: bhaskargurram-ai/turnloom@v0.7.0`), and its `Dockerfile` builds an image for isolated, unattended runs.
|
|
187
|
+
- **Documents and undo for MCP.** [VerifyDoc](https://github.com/bhaskargurram-ai/verifydoc) scores extracted fields against their source. [Unwind](https://github.com/bhaskargurram-ai/unwind) classifies MCP calls by reversibility and can take them back.
|
|
188
|
+
- **Benchmarks.** `turnloom-agent` is a headless entry point with a [Harbor](https://github.com/harbor-framework/harbor) adapter and ATIF export. Turnloom has not been run on a public leaderboard. [Status and how to run it](docs/leaderboard.md)
|
|
189
|
+
|
|
190
|
+
Each of these is described with a working example in the [integration guide](docs/integrations.md).
|
|
191
|
+
|
|
192
|
+
## What Turnloom is not
|
|
193
|
+
|
|
194
|
+
It is a small agent: one loop, a handful of tools, no background services and no telemetry. It does not sandbox commands at the operating system level or index your repository. If you need isolation, run it in the provided container. It has no published benchmark score; the evaluation tools are there so you can measure it on your own tasks.
|
|
195
|
+
|
|
196
|
+
## Documentation
|
|
197
|
+
|
|
198
|
+
- [Design: the agent loop and the context store](docs/design.md)
|
|
199
|
+
- [Providers, model discovery and credentials](docs/providers.md)
|
|
200
|
+
- [Integrations: MCP, skills, proxy, CI, containers](docs/integrations.md)
|
|
201
|
+
- [Desktop app](docs/desktop.md)
|
|
202
|
+
- [Experiments: comparing two configurations](docs/experiments.md)
|
|
203
|
+
- [Leaderboard status](docs/leaderboard.md)
|
|
204
|
+
- [Security model and reporting](SECURITY.md)
|
|
205
|
+
- [Contributing](CONTRIBUTING.md)
|
|
206
|
+
|
|
207
|
+
## License
|
|
208
|
+
|
|
209
|
+
Turnloom is released under the [MIT License](LICENSE). Vendored personas keep the [Agency Agents license](turnloom/personas/LICENSE). Provider presets derive from [Models.dev](https://models.dev) under [its license](turnloom/data/LICENSE.models-dev). Studio bundles open-source JavaScript packages listed in [THIRD-PARTY.txt](turnloom/studio_assets/THIRD-PARTY.txt).
|
turnloom-0.7.0/README.md
ADDED
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
Turnloom is a coding agent for your terminal and desktop that shows you what it keeps in context and what each call costs. It reads and edits files, runs commands with your approval, and folds older tool output out of the prompt into a local archive that you and the model can read back at any time. Every edit is shown as a diff before it lands and can be undone afterwards. Every model call is metered.
|
|
4
|
+
|
|
5
|
+
It works with any OpenAI-compatible endpoint: hosted providers, OpenRouter, or a model on your own machine through Ollama, LM Studio, vLLM or llama.cpp. LiteLLM adds Anthropic, Bedrock, Vertex AI and Azure.
|
|
6
|
+
|
|
7
|
+
[Install](#install) · [Studio](#studio) · [Terminal](#terminal) · [Staying in control](#staying-in-control) · [How context works](#how-context-works) · [Works with](#works-with) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
Turnloom needs Python 3.11 or newer. The core has one dependency.
|
|
12
|
+
|
|
13
|
+
```sh
|
|
14
|
+
pipx install "git+https://github.com/bhaskargurram-ai/turnloom"
|
|
15
|
+
turnloom connect # pick a provider and a model
|
|
16
|
+
turnloom chat # start working in the current directory
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
`uv tool install "git+https://github.com/bhaskargurram-ai/turnloom"` and `pip install` work the same way. Each [release](https://github.com/bhaskargurram-ai/turnloom/releases) also carries a wheel. On Windows you can instead clone the repository and double-click **Open Turnloom Studio.cmd**, which creates its own environment.
|
|
20
|
+
|
|
21
|
+
`turnloom connect` lists providers and their models. Choose OpenRouter to sign in through your browser, choose Ollama or LM Studio to use a local model, or pick any other provider and paste its key once. Keys go to your operating system's credential store, never to a file. `turnloom doctor` checks the setup. [Provider guide](docs/providers.md)
|
|
22
|
+
|
|
23
|
+
## Studio
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
pipx install "turnloom[studio] @ git+https://github.com/bhaskargurram-ai/turnloom"
|
|
27
|
+
turnloom studio
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Studio is a workbench that opens in its own window, or in a browser tab with `--browser`. The base install runs it too; the `studio` extra adds the native window, the policy gate, exact token counts and document tools.
|
|
31
|
+
|
|
32
|
+

|
|
33
|
+
|
|
34
|
+
| View | Use it to |
|
|
35
|
+
| --- | --- |
|
|
36
|
+
| **Code** | Edit files beside the agent's work log. The reply streams in, each tool call shows what ran, and edits arrive as diffs to approve, reject, or allow for the session. After a turn, review every file it touched and revert the turn's edits. |
|
|
37
|
+
| **Context Loom** | See each tool result's original size and what the prompt still carries. Open any folded result to read the archived original without spending a model call. |
|
|
38
|
+
| **Changes** | Compare the working tree with the last commit. |
|
|
39
|
+
| **Agents** | Pick from 285 personas, or line several up as a team that plans, builds and reviews in stages. |
|
|
40
|
+
| **Cost** | See tokens and estimated cost per call, how full the context window is and what fills it, and set a budget per turn. |
|
|
41
|
+
| **Policy** | Gate every tool call with Provio: what was allowed, asked and denied, a tester for a command or path, and the ledger's integrity. |
|
|
42
|
+
| **Tools** | Turn MCP servers on for the agent and inspect the tools each one offers. |
|
|
43
|
+
| **Documents** | Extract fields from a document with VerifyDoc and see each value's confidence and where it was read. |
|
|
44
|
+
| **Undo ledger** | Review what Unwind recorded for MCP calls, set checkpoints and take actions back. |
|
|
45
|
+
|
|
46
|
+
Sessions are saved in the workspace; start a new one or resume an earlier one. Press **Ctrl+K** for the command palette.
|
|
47
|
+
|
|
48
|
+
Studio listens on 127.0.0.1 only and requires a per-launch token on every request. Details are in [SECURITY.md](SECURITY.md). To ship it as a standalone app folder, see [Desktop app](docs/desktop.md).
|
|
49
|
+
|
|
50
|
+
## Terminal
|
|
51
|
+
|
|
52
|
+
| Command | What it does |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| `turnloom chat` | Work across several turns. `/diff`, `/undo`, `/new` and `/help` are available inside. |
|
|
55
|
+
| `turnloom run "Fix the failing parser test"` | Run one task and exit with status 0 when it completes. |
|
|
56
|
+
| `turnloom run "Review the staged diff" --persona reviewer --read-only` | Explore and report without edits or commands. |
|
|
57
|
+
| `turnloom chat --resume` | Continue the most recent session. `--resume ID` picks one. |
|
|
58
|
+
| `turnloom sessions` | List saved sessions in this workspace. |
|
|
59
|
+
| `turnloom undo` | Restore the files edited by the last turn of a session. |
|
|
60
|
+
| `turnloom team "Add input validation"` | Plan, build and review in three stages that share one budget. Planning and review cannot edit. |
|
|
61
|
+
| `turnloom personas --search security` | Browse personas. Use one with `--persona ID`. |
|
|
62
|
+
| `turnloom proxy` | Fold and meter requests from another harness. |
|
|
63
|
+
| `turnloom replay PATH`, `turnloom atif TRANSCRIPT OUTPUT` | Print a saved session offline, or export it as an ATIF trajectory. |
|
|
64
|
+
| `turnloom studio`, `turnloom doctor` | Open the workbench. Report version, connection, optional features and workspace state. |
|
|
65
|
+
|
|
66
|
+
For scripts and CI, `--json` prints one result object and `--events` prints each session event as a JSON line while it happens.
|
|
67
|
+
|
|
68
|
+
## Staying in control
|
|
69
|
+
|
|
70
|
+
Turnloom asks before it runs a command, edits a file or calls an MCP tool. Reading and searching files inside the workspace does not need approval, and those reads are sent to the model you connected.
|
|
71
|
+
|
|
72
|
+
| Mode | Flag | Behavior |
|
|
73
|
+
| --- | --- | --- |
|
|
74
|
+
| Ask (default) | none | Approve each command and edit. Answer `a` to allow all later edits, or that exact command, for the session. |
|
|
75
|
+
| Auto-edit | `--auto-edit` | Edits apply without asking. Commands still ask. |
|
|
76
|
+
| Allowlist | `--allow "pytest*"` | Simple commands matching the pattern run without asking. A pattern never covers a command that chains, pipes, redirects or substitutes. |
|
|
77
|
+
| Read-only | `--read-only` | No edits and no shell. The agent can only read, search and answer. |
|
|
78
|
+
| Unattended | `--yes` | Everything is approved. Use it only inside a container or a disposable checkout. |
|
|
79
|
+
|
|
80
|
+
Other limits you can set per task: `--budget 0.25` stops before the estimated cost passes that amount, `--max-steps` caps model calls (100 by default), and `--deadline` caps wall time. At the step limit the agent spends its last call writing up what it found. Three identical tool calls in a row end tool use the same way. The other limits stop the turn and say why.
|
|
81
|
+
|
|
82
|
+
Commands run with your user's permissions. Model API keys are removed from the environment that commands see. Files that usually hold secrets, such as `.env`, private keys and credential files, are closed to the file tools.
|
|
83
|
+
|
|
84
|
+
### A policy under the agent
|
|
85
|
+
|
|
86
|
+
[Provio](https://github.com/writ-agent/provio) checks each tool call against a `provio.yaml` in your repository before it runs, and writes every decision to a hash-chained ledger at `.provio/ledger.jsonl`. Turnloom turns the gate on whenever the workspace has that file and the `guard` extra is installed. Create a starter policy from Studio's Policy view or with `provio init`.
|
|
87
|
+
|
|
88
|
+
| Verdict | What happens |
|
|
89
|
+
| --- | --- |
|
|
90
|
+
| deny | The tool does not run. The model reads the rule and its reason, so it can correct course. |
|
|
91
|
+
| ask | You decide, and the approval shows the rule that asked. With `--yes` there is nobody to ask, so the call is refused. |
|
|
92
|
+
| allow | The call runs. By default you still confirm each call; in Studio choose the policy mode to be asked only when a rule says ask. |
|
|
93
|
+
| redact | The call runs and the model receives Provio's redacted output. |
|
|
94
|
+
|
|
95
|
+
The gate covers shell commands, file reads, file edits and MCP tool calls, and it fails closed: if Provio cannot answer, the tool does not run. Pass `--no-gate` to run once without the policy.
|
|
96
|
+
|
|
97
|
+
## How context works
|
|
98
|
+
|
|
99
|
+
Long sessions fill the prompt with old tool output. Turnloom handles that without a summarizing model call:
|
|
100
|
+
|
|
101
|
+
1. **Fold.** The three most recent tool results stay whole. Older results longer than 800 characters are replaced in the prompt by a short preview of their start and end and a reference. Results the model has not read yet are never folded.
|
|
102
|
+
2. **Archive.** The full text stays in the session's archive. When a command prints more than fits, the prompt gets the head and tail and the archive keeps the rest.
|
|
103
|
+
3. **Recall.** The model calls `recall` with a reference to read a slice or search inside an archived result. You can open the same reference in Studio.
|
|
104
|
+
4. **Overflow.** If the conversation still outgrows the model's window, the oldest exchanges move to the archive as a unit and their references are listed for the model. Nothing is dropped without a way back.
|
|
105
|
+
|
|
106
|
+
The transcript of every session is a JSON Lines file under `.turnloom/` in the workspace, with a `.gitignore` that keeps traces out of version control. `--resume` rebuilds the conversation and its archive from that file. Studio and the proxy also append every model call to `.turnloom/usage.jsonl`.
|
|
107
|
+
|
|
108
|
+
Use `--no-fold` to compare a run with folding against one without. The receipt reports folded characters, input and output tokens, and cached tokens when the provider reports them; cached input is priced at the provider's cache rate when it lists one. Folding rewrites earlier messages, so on providers with prompt caching it trades some cache hits for a smaller prompt. Measure on your own tasks before relying on it. [Design notes](docs/design.md) · [Measuring it yourself](docs/experiments.md)
|
|
109
|
+
|
|
110
|
+
## Works with
|
|
111
|
+
|
|
112
|
+
- **Project instructions.** `AGENTS.md` at the workspace root is added to the agent's instructions, with `CLAUDE.md` as a fallback.
|
|
113
|
+
- **Agent Skills.** Skills checked into `.agents/skills` or `.claude/skills` are listed for the model, which reads one when a task calls for it.
|
|
114
|
+
- **Personas.** Builder and Debugger are Turnloom's own. The other 283 come from [Agency Agents](https://github.com/msitarzewski/agency-agents), vendored at commit `8ae6164`. Add your own as Markdown files in `.turnloom/personas/`.
|
|
115
|
+
- **MCP servers.** `--mcp servers.json`, or `.turnloom/mcp.json` in Studio, connects stdio and streamable HTTP servers. The model searches a server's tools and calls them with your approval.
|
|
116
|
+
- **Other agents, as a server.** `turnloom serve` is an MCP server: session receipts, archived tool results, a place to park long output, and with `--allow-run` task delegation to Turnloom.
|
|
117
|
+
- **Other harnesses, as a layer.** `turnloom proxy` serves an OpenAI-compatible endpoint that folds and meters another harness's requests to your connected model.
|
|
118
|
+
- **Native provider APIs.** With the `llm` extra, `turnloom connect litellm:anthropic` and its siblings reach providers that are not OpenAI-compatible, through [LiteLLM](https://github.com/BerriAI/litellm).
|
|
119
|
+
- **CI and containers.** The repository is a GitHub Action (`uses: bhaskargurram-ai/turnloom@v0.7.0`), and its `Dockerfile` builds an image for isolated, unattended runs.
|
|
120
|
+
- **Documents and undo for MCP.** [VerifyDoc](https://github.com/bhaskargurram-ai/verifydoc) scores extracted fields against their source. [Unwind](https://github.com/bhaskargurram-ai/unwind) classifies MCP calls by reversibility and can take them back.
|
|
121
|
+
- **Benchmarks.** `turnloom-agent` is a headless entry point with a [Harbor](https://github.com/harbor-framework/harbor) adapter and ATIF export. Turnloom has not been run on a public leaderboard. [Status and how to run it](docs/leaderboard.md)
|
|
122
|
+
|
|
123
|
+
Each of these is described with a working example in the [integration guide](docs/integrations.md).
|
|
124
|
+
|
|
125
|
+
## What Turnloom is not
|
|
126
|
+
|
|
127
|
+
It is a small agent: one loop, a handful of tools, no background services and no telemetry. It does not sandbox commands at the operating system level or index your repository. If you need isolation, run it in the provided container. It has no published benchmark score; the evaluation tools are there so you can measure it on your own tasks.
|
|
128
|
+
|
|
129
|
+
## Documentation
|
|
130
|
+
|
|
131
|
+
- [Design: the agent loop and the context store](docs/design.md)
|
|
132
|
+
- [Providers, model discovery and credentials](docs/providers.md)
|
|
133
|
+
- [Integrations: MCP, skills, proxy, CI, containers](docs/integrations.md)
|
|
134
|
+
- [Desktop app](docs/desktop.md)
|
|
135
|
+
- [Experiments: comparing two configurations](docs/experiments.md)
|
|
136
|
+
- [Leaderboard status](docs/leaderboard.md)
|
|
137
|
+
- [Security model and reporting](SECURITY.md)
|
|
138
|
+
- [Contributing](CONTRIBUTING.md)
|
|
139
|
+
|
|
140
|
+
## License
|
|
141
|
+
|
|
142
|
+
Turnloom is released under the [MIT License](LICENSE). Vendored personas keep the [Agency Agents license](turnloom/personas/LICENSE). Provider presets derive from [Models.dev](https://models.dev) under [its license](turnloom/data/LICENSE.models-dev). Studio bundles open-source JavaScript packages listed in [THIRD-PARTY.txt](turnloom/studio_assets/THIRD-PARTY.txt).
|