clawops 0.2.2__tar.gz → 0.2.4__tar.gz

clawops-0.2.4/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/clawops/_version.py'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/ -v
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=$(python -c "exec(open('src/clawops/_version.py').read()); print(__version__)")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - run: pip install build
+      - run: python -m build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create git tag
+        run: |
+          git tag "v${{ steps.version.outputs.version }}"
+          git push origin "v${{ steps.version.outputs.version }}"
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          gh release create "v${VERSION}" dist/* \
+            --title "v${VERSION}" \
+            --generate-notes

{clawops-0.2.2 → clawops-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawops
-Version: 0.2.2
+Version: 0.2.4
 Summary: The official Python library for the ClawOps Voice API
 Project-URL: Homepage, https://github.com/learners-superpumped/clawops-python
 Project-URL: Documentation, https://docs.claw-ops.com
@@ -104,7 +104,7 @@ async def on_start(call):
 agent.listen()  # WebSocket 연결 후 인바운드 대기
 ```
 
-> 자세한 사용법은 **[Agent 문서](docs/agent.md)** 를 참고하세요.
+> 자세한 사용법은 **[Agent 문서](docs/agent.md)** 를 참고하세요. (Tool, 이벤트, 통화 녹음, 파이프라인 모드, MCP 연동 등)
 
 ## REST API 사용법
 

{clawops-0.2.2 → clawops-0.2.4}/README.md

@@ -47,7 +47,7 @@ async def on_start(call):
 agent.listen()  # WebSocket 연결 후 인바운드 대기
 ```
 
-> 자세한 사용법은 **[Agent 문서](docs/agent.md)** 를 참고하세요.
+> 자세한 사용법은 **[Agent 문서](docs/agent.md)** 를 참고하세요. (Tool, 이벤트, 통화 녹음, 파이프라인 모드, MCP 연동 등)
 
 ## REST API 사용법
 

{clawops-0.2.2 → clawops-0.2.4}/docs/agent.md

@@ -10,6 +10,7 @@
 - [설정 옵션](#설정-옵션)
 - [Tool (함수 호출)](#tool-함수-호출)
 - [이벤트 핸들러](#이벤트-핸들러)
+- [통화 녹음](#통화-녹음)
 - [파이프라인 모드 (커스텀 STT/LLM/TTS)](#파이프라인-모드-커스텀-sttllmtts)
 - [MCP 서버 연동](#mcp-서버-연동)
 - [CallSession](#callsession)
@@ -100,6 +101,10 @@ agent = ClawOpsAgent(
     eagerness="high",                 # 응답 적극성: low, medium, high, auto
     greeting=True,                    # 첫 인사 자동 생성 여부
 
+    # 녹음
+    recording=True,                       # 통화 녹음 활성화
+    recording_path="./recordings",        # 저장 경로 (기본값: ./recordings)
+
     # 고급
     base_url="https://api.claw-ops.com",  # API 엔드포인트
 )
@@ -198,6 +203,35 @@ async def on_transcript(call, role, text):
 | `call_end` | `(call)` | 통화 종료 |
 | `transcript` | `(call, role, text)` | 음성 텍스트 생성 |
 
+## 통화 녹음
+
+`recording=True`로 통화를 실시간 녹음할 수 있습니다. 통화마다 3개 WAV 파일(PCM16 8kHz mono)이 생성됩니다.
+
+```python
+agent = ClawOpsAgent(
+    from_="07012341234",
+    system_prompt="상담원입니다.",
+    recording=True,
+    recording_path="./recordings",  # 기본값
+)
+```
+
+### 생성되는 파일
+
+| 파일 | 내용 |
+|------|------|
+| `{call_id}_in.wav` | 발신자 음성 (수신 오디오) |
+| `{call_id}_out.wav` | AI 응답 (송신 오디오) |
+| `{call_id}_mix.wav` | 양방향 믹스 |
+
+### 동작 원리
+
+- 수신 오디오(발신자)가 타임라인 역할을 합니다
+- 송신 오디오(AI 응답)는 버퍼에 쌓이고, 수신 청크가 올 때마다 같은 길이만큼 꺼내서 샘플 단위로 믹스합니다
+- 별도 시간 관리 없이 자연스럽게 정렬됩니다
+- 파일은 실시간으로 기록되므로 통화 중 디스크에 바로 저장됩니다
+- 통화 종료 시 WAV 헤더가 최종 크기로 업데이트됩니다
+
 ## 파이프라인 모드 (커스텀 STT/LLM/TTS)
 
 OpenAI Realtime 대신 직접 STT, LLM, TTS 프로바이더를 조합할 수 있습니다.
@@ -374,6 +408,11 @@ ClawOpsAgent
 │   ├── to_openai_tools()   # JSON Schema 자동 생성
 │   └── call()              # 이름으로 함수 호출
 │
+├── AudioRecorder (콜별)    # 실시간 녹음 (recording=True 시)
+│   ├── write_inbound()     # 수신 오디오 → _in.wav + _mix.wav
+│   ├── write_outbound()    # 송신 오디오 → _out.wav + mix 버퍼
+│   └── stop()              # WAV 헤더 업데이트
+│
 ├── CallSession (콜별)      # 통화 상태 관리
 │   ├── audio_stream()      # 수신 오디오 스트림
 │   ├── send_audio()        # 응답 오디오 전송

clawops-0.2.4/src/clawops/_version.py

@@ -0,0 +1 @@
+__version__ = "0.2.4"

clawops-0.2.2/.claude/settings.local.json

@@ -1,22 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Read(//Users/ghyeok/Developments/clawops/**)",
-      "WebSearch",
-      "mcp__plugin_context7_context7__resolve-library-id",
-      "mcp__plugin_context7_context7__query-docs",
-      "Bash(git:*)",
-      "Bash(pip install:*)",
-      "Bash(pytest:*)",
-      "Bash(python:*)",
-      "Bash(mypy:*)",
-      "Bash(ruff check:*)",
-      "Bash(twine upload:*)",
-      "Bash(node:*)",
-      "Skill(commit-commands:commit)",
-      "Bash(git rm:*)",
-      "Bash(grep:*)",
-      "Bash(gcloud compute ssh sip-callbot-vm:*)"
-    ]
-  }
-}

clawops-0.2.2/src/clawops/_version.py

@@ -1 +0,0 @@
-__version__ = "0.2.2"