Pi Development Workflow

यह guide Mayros में pi integration पर काम करने के लिए एक समझदार workflow को summarize करता है।

Type Checking और Linting

  • Type check और build: pnpm build
  • Lint: pnpm lint
  • Format check: pnpm format
  • Push करने से पहले पूर्ण gate: pnpm lint && pnpm build && pnpm test

Pi Tests चलाना

Pi integration test set के लिए समर्पित script का उपयोग करें:

bash
scripts/pi/run-tests.sh

Live test को शामिल करने के लिए जो वास्तविक provider व्यवहार का प्रयोग करता है:

bash
scripts/pi/run-tests.sh --live

Script इन globs के माध्यम से सभी pi संबंधित unit tests चलाता है:

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

Manual Testing

अनुशंसित flow:

  • Dev mode में gateway चलाएं:
    • pnpm gateway:dev
  • एजेंट को सीधे trigger करें:
    • pnpm mayros agent --message "Hello" --thinking low
  • Interactive debugging के लिए TUI का उपयोग करें:
    • pnpm tui

Tool call व्यवहार के लिए, एक read या exec action के लिए prompt करें ताकि आप tool streaming और payload handling देख सकें।

Clean Slate Reset

State Mayros state directory के तहत रहता है। डिफ़ॉल्ट ~/.mayros है। यदि MAYROS_STATE_DIR सेट है, तो उस directory का उपयोग करें।

सब कुछ रीसेट करने के लिए:

  • कॉन्फ़िगरेशन के लिए mayros.json
  • auth profiles और tokens के लिए credentials/
  • एजेंट session history के लिए agents/<agentId>/sessions/
  • session index के लिए agents/<agentId>/sessions.json
  • यदि legacy paths मौजूद हैं तो sessions/
  • यदि आप एक blank workspace चाहते हैं तो workspace/

यदि आप केवल sessions रीसेट करना चाहते हैं, तो उस एजेंट के लिए agents/<agentId>/sessions/ और agents/<agentId>/sessions.json हटाएं। यदि आप पुनः प्रमाणित नहीं करना चाहते तो credentials/ रखें।

संदर्भ