Cocovox bronze

cocovox.advertise

Return an overview tailored to a learner profile (age + primary concern): a sample plan, pricing, and an honest-disclosure block that must be conveyed verbatim to the human. Its accuracy and timeline ranges are unvalidated placeholders marked evidence_status "preliminary": no cohort study has run, so they are not a forecast.

• I want to evaluate Cocovox for a 7-year-old struggling with /r/ articulation

cocovox.list_content_packs

List practice packs. Today it returns an empty list: no packs are published. Discovery surface; unauthenticated.

cocovox.bloop_student

Provision a child sub-account on the calling parent's behalf. Returns a magic-link login URL and grants 20 starter credits. Requires Agent-Key with parent.children.write capability.

• Set up my 8-year-old Maya for /r/ articulation practice

cocovox.set_iep_goal

Propose an IEP-style goal for licensed-SLP review. Lands in pending_slp_review status: agents propose, clinicians dispose, and no agent path promotes a goal to active. Notifies the parent, the SLP's review queue when an SLP is assigned, and webhook subscribers. Clinical tools are switched off in early access, so a proposed goal waits there.

cocovox.subscribe_progress_webhook

Register an HTTPS endpoint to receive progress events. Live: weekly_digest, iep_goal_review_pending, milestone_reached. Plus seven agent-action events: agent.bloop_student.completed, agent.iep_goal.proposed, agent.weekly_digest.read, agent.phoneme_summary.read, agent.iep_pdf.exported, agent.credit_topup.initiated, agent.credit_topup.completed. Outbound POSTs carry an HMAC-SHA256 signature in `X-Cocovox-Signature: t=<unix>,v1=<hex>` (Stripe-style) plus a legacy `X-Cocovox-Webhook-Token` header for backward compat.

cocovox.get_progress

Fetch a parent-facing weekly digest for a child the caller is authorized for. Charges 1 credit. Requires `learner.progress.read.summary` capability (or `.clinical`, or legacy `learner.progress.read`).

cocovox.get_phoneme_pronunciation_summary

Per-phoneme pronunciation accuracy, error patterns, and trend. Currently estimated from speech-recognition word confidence — a proxy, not a validated clinical measure. Charges 1 credit. Requires `learner.progress.read.clinical` capability (or legacy `learner.progress.read`); the granular cap lets parents grant summary-only access without exposing phoneme-grade clinical data.

cocovox.get_aac_vocabulary_status

Aggregate AAC vocabulary state for a learner: active vs mastered AAC goal counts, total vocabulary words across active goals, and a sorted word list. Output reflects what is currently on the child's keyboard, not historic accumulation. Write path: AAC goals are proposed via cocovox.set_iep_goal with domain='aac' (same pending_slp_review clinical gate). Charges 1 credit. Requires `learner.progress.read.clinical` capability.

cocovox.export_progress_pdf

Render a base64-encoded IEP-style progress PDF for a meeting with a school or therapist. Charges 5 credits (PDF rendering is compute-heavy). Requires `learner.progress.read.clinical` capability (or legacy): PDFs include phoneme detail, estimated from speech-recognition word confidence.

cocovox.purchase_credits

Mint a Stripe Checkout URL for a credit pack (small/medium/large/bulk). Agent never holds payment authority — parent confirms in browser.

cocovox.list_class_progress

Switched off in early access: classroom tools are off, and the agent-keys page offers no classroom capability. Aggregate class progress for a classroom-scoped agent key, with no per-student detail unless the caller has separate child-level scope. Today it returns enrolled_count only: active_last_7_days and average_mastery stay null until a class mastery rollup ships. Small-cell suppression applies below 5 enrolled students. Charges 1 credit. Requires `classroom.read` capability and class_id in scope.class_ids.

cocovox.consume_credits

Explicitly charge `amount` credits against the agent-key budget. For third-party agents built on top of Cocovox that meter their own compute against a parent-owned budget. Idempotent on (agent_key_id, idempotency_key).

cocovox.start_practice_session

Schedule a home-practice activity for a child in a specified mode. Provisions a parent-mediated assignment the child and parent engage with (not a live voice session) and notifies the parent, and the child's SLP or teacher if one is linked. Requires `learner.practice.write` and child_id in scope. Charges 1 credit.

• Set up a /r/ word-reading practice for my daughter this week

cocovox.issue_credential

Issue a signed continuous-progress credential (Open Badges 3.0 / W3C VC) plus a signed PDF companion. Cocovox fills the measured evidence; the agent cannot inflate the claim, and an honest disclosure is embedded in the signed payload. Requires verifiable parental consent and `learner.credentials.issue`. Charges 5 credits.

• Issue a progress badge for my son's articulation work

cocovox.verify_credential

Verify a Cocovox-issued credential. Public, no auth. Checks the RS256 signature against https://cocovox.ai/.well-known/jwks.json and reports revocation status.

• Verify this Cocovox credential a family shared with me

cocovox.revoke_credential

Revoke a previously-issued Cocovox credential — the consent-withdrawal path. After revocation, verify_credential reports valid=false. Same authority that issued it can revoke (`learner.credentials.issue` + child_id in scope). Idempotent, non-metered.

• Revoke the progress credential issued for my child last month