{ "format": "agent-article-v0", "article_id": "EA-138", "canonical_url": "/tools/ea-138-mastra", "page_type": "reference", "claim_ids": [], "evidence_ids": [ "EVD-EA-138-URL-8355397B8EEC", "EVD-EA-138-URL-E8CFF2E99128", "EA-138-R11-RESEARCH", "EA-138-R11-WEB-READBACK" ], "unknown_ids": [ "EA-138-UNKNOWN-01", "EA-138-UNKNOWN-02", "EA-138-UNKNOWN-CURRENTNESS" ], "operational_object_ids": [], "provider": [], "models": [], "plans": [], "surfaces": [], "regions": [], "current_status": "UNKNOWN", "observation_status": "SPEC_ONLY", "freshness": "UNKNOWN", "last_verified": null, "supersedes": [], "superseded_by": [], "provenance": [ "COMM-044-EA0138", "SRC-EA-138-URL-8355397B8EEC", "SRC-EA-138-URL-E8CFF2E99128", "WEBBODY-EA0138-R8-80B6EC5F" ], "article_sources": [ { "id": "EVD-EA-138-URL-8355397B8EEC", "evidence_class": "RESEARCH", "title": "source_class=official project documentation; exact_title=Get started with Mastra; author/org=Mastra; canonical_url=", "href": "https://mastra.ai/docs", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-138-URL-8355397B8EEC" ], "supporting_locators": [ "EVIDENCE_TABLE", "- source_class=official project documentation; exact_title=Get started with Mastra; author/org=Mastra; canonical_url=https://mastra.ai/docs" ], "scope": "EVIDENCE_TABLE", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EVD-EA-138-URL-E8CFF2E99128", "evidence_class": "RESEARCH", "title": "source_class=official product documentation; exact_title=Observability; author/org=Mastra; canonical_url=", "href": "https://mastra.ai/docs/observability/overview", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-138-URL-E8CFF2E99128" ], "supporting_locators": [ "EVIDENCE_TABLE", "- source_class=official product documentation; exact_title=Observability; author/org=Mastra; canonical_url=https://mastra.ai/docs/observability/overview" ], "scope": "EVIDENCE_TABLE", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EA-138-R11-RESEARCH", "evidence_class": "RESEARCH", "title": "EA-138 監査済みresearch / canonical revision binding", "supports": [ "- ESTABLISHED: 公式DocsはMastraをTypeScript frameworkとして、agents、workflows、tools、memory、model provider形式、Studioでのbuild/test/manage、observabilityを記載している。Docsの導入例にはtool input schema/execute、agent登録、npmベースの実装入口がある。\n- NOT_ESTABLISHED: framework・Studio・model routerの機能記述は、全provider/model、全plan/region、全deploymentでの利用可否、agent品質・安全性・SLA、実際の保存・削除条件を確立しない。" ], "limit": "canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。", "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET", "source_or_experiment_ids": [ "COMM-044-EA0138" ], "supporting_locators": [ "COMM-044-EA0138", "EA-138-R5-LEGACY-MIGRATION-20261008-R1", "content/staging/EA-138.md" ], "scope": "監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。", "provenance_status": "AUDIT_PASS_CANONICAL_BINDING" }, { "id": "EA-138-R11-WEB-READBACK", "evidence_class": "IMPL", "title": "EA-138 Web body identity / canonical readback", "supports": [ "canonical staging bodyのSHA-256一致とR9 canonical ledger readbackをProduction projectionの入力として検証する。" ], "limit": "body identity/readbackは本文claim自体の真偽や外部ソースの最新性を追加保証しない。", "checked_at": null, "origin_class": "IMPLEMENTATION_READBACK", "source_or_experiment_ids": [ "WEBBODY-EA0138-R8-80B6EC5F" ], "supporting_locators": [ "WEBBODY-EA0138-R8-80B6EC5F", "content/staging/EA-138.md", "EA-138-R5-LEGACY-MIGRATION-20261008-R1" ], "scope": "R9/R10 canonical readback後のProduction生成時body identity。", "provenance_status": "CANONICAL_READBACK_BODY_HASH_MATCH" } ], "research_sections": [ { "heading": "WHY_THIS_MATTERS_TO_UPDATE", "text": "TypeScript/Node系でagent、workflow、memory、tool、Studio、observabilityを束ねる実装の現行境界を、OSS frameworkと管理製品のoverlayに分けて更新する。" }, { "heading": "SCOPE_ROUTING", "text": "Enterprise AI Core / implementation / interoperability / governance / audit / operability。Mastra framework、Studio、model router、外部providerを混同しない。" }, { "heading": "CLAIM_OR_RESEARCH_QUESTION", "text": "現行Mastra公式Docsがagents/workflows/tools/memory/Studio/observabilityとmodel/provider設定をどの範囲で明示しているか。" }, { "heading": "EVIDENCE_TABLE", "text": "- source_class=official project documentation; exact_title=Get started with Mastra; author/org=Mastra; canonical_url=https://mastra.ai/docs; publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current @mastra/core docs（docsは@mastra/core@latest等の導入を案内、固定versionなし）; supporting_locator=Get started / Agent and tool setup / Mastra Studio / Quickstart（TypeScript framework、Agent/Tool、provider/model形式、npm create mastra、Studioがagent/workflow/toolのbuild・test・manage interface、model routerへの言及）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+limit\n- source_class=official product documentation; exact_title=Observability; author/org=Mastra; canonical_url=https://mastra.ai/docs/observability/overview; publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current docs; supporting_locator=Observability overview（agent run、workflow step、tool call、model interactionを可視化するobservabilityの説明）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+context" }, { "heading": "FINDINGS", "text": "- ESTABLISHED: 公式DocsはMastraをTypeScript frameworkとして、agents、workflows、tools、memory、model provider形式、Studioでのbuild/test/manage、observabilityを記載している。Docsの導入例にはtool input schema/execute、agent登録、npmベースの実装入口がある。\n- NOT_ESTABLISHED: framework・Studio・model routerの機能記述は、全provider/model、全plan/region、全deploymentでの利用可否、agent品質・安全性・SLA、実際の保存・削除条件を確立しない。" }, { "heading": "LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE", "text": "@latest依存の更新でAPI・provider adapterが変わり得る。schemaを通った誤情報、memory汚染、workflow state race、tool副作用、observability欠損、model routerの誤選択が残る。Docsの顧客利用例・「production」表現は独立benchmarkではない。" }, { "heading": "AVAILABILITY_GATES", "text": "Node/TypeScript版、@mastra/coreと関連packageの固定release、supported provider/model・資格情報・契約・地域、Studio/Server/Storage/Auth/Deploy機能、memory/observability backend、tool OAuth・RBAC・データ保持。" }, { "heading": "IMPLEMENTATION_STATE", "text": "OSS/TypeScript framework documentation + PRODUCT_VOLATILE。Docs exampleとnpm導入案内は実装入口。管理Studio・外部接続・認証済みtenant・本番負荷試験は未実施。" }, { "heading": "BENCHMARK_OR_EVAL", "text": "公式DocsがStudioのtest、traces、metrics、evalsを案内することは機能存在の根拠。品質・安全・cost・latency・memory recallの独立再現benchmarkは本Packetで確認していない。UNKNOWN。" }, { "heading": "SECURITY / PRIVACY / AUDIT / COST / OPERABILITY", "text": "Security=tool schema、approval、RBAC、providerごとの権限を分離。Privacy=memory・storage・trace・外部providerへの送信を記録。Audit=agent/workflow/tool/model/version/stateを相関。Cost=router選択・LLM・tool・memory・trace・retryを含む。Operability=version pin、migration、timeout、idempotency、rollback、provider outageを検証。" }, { "heading": "SAFE_WORDING_FOR_FUTURE_BOOK", "text": "「Mastraの現行Docsは、TypeScript上のagent・workflow・tool・memory・Studio・observabilityを案内している。これは実装要素の存在根拠であり、全provider・plan・regionでの利用可否、業務品質、権限安全性、production SLOの保証ではない。」" }, { "heading": "UPDATE_WORK_HANDOFF", "text": "CoreのTypeScript framework欄とproduct overlay欄を分ける。次回は固定npm release/commit、license、provider/model matrix、Studio/Storage/Authの契約境界、trace/memory data policy、公開issue/incident、再現可能evalを補う。" }, { "heading": "OPEN_UNKNOWN", "text": "current package versions、model routerの選択規則とfallback、memory consistency、Studioの権限・監査粒度、provider/region差、workflow recovery、実業務benchmark。" }, { "heading": "STOP_CONDITION", "text": "npm導入成功を運用可能性へ拡張しない。model router・memory・observabilityの存在を、正しさ・プライバシー・SLAの自動保証と書かない。\nUNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED\n\n---" }, { "heading": "AUDITED_BOUNDARY", "text": "Mastra currentness @mastra/core@1.71.0 as-of 2026-09-25. Keep OSS framework separate from Studio/Platform, storage/observability backends and external providers. Durable resume is not exactly-once side-effect delivery. Schema/policy primitives are not semantic truth or authorization. Independent production SLO/benchmark UNKNOWN; author-maintained duplicate-live-delivery issue retained as counterevidence." }, { "heading": "OPEN_UNKNOWN", "text": "All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from authority/audit remain open unless explicitly closed by the audited handoff." } ], "human_url": "/tools/ea-138-mastra", "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-138-mastra", "json_url": "/agent/article.json?path=%2Ftools%2Fea-138-mastra" }