{"openapi":"3.1.0","x-cors":{"allowedOrigins":["*"],"allowedMethods":["GET","OPTIONS"],"allowedHeaders":["Accept"],"credentials":false},"info":{"title":"ainew.jp Tools Agent API","version":"1.4","description":"無料ブラウザツールを検索し、入力・出力形式、安全な組み合わせ辺、プライバシー境界、実行ページURLを返す読み取り専用API。"},"servers":[{"url":"https://tools.ainew.jp"}],"components":{"schemas":{"WorkflowCompletionReceipt":{"type":"object","additionalProperties":false,"required":["schemaVersion","receiptType","receiptId","planId","planRevision","workflowId","stage","automaticExecutionAllowed","externalActionIncluded","createdAt","toolSteps","inputContinuity","finalReview","privacy","trust"],"properties":{"schemaVersion":{"type":"string","const":"1.2"},"receiptType":{"type":"string","const":"ainew.local-workflow-completion"},"receiptId":{"type":"string","minLength":1,"maxLength":180},"planId":{"type":"string","minLength":1,"maxLength":100},"planRevision":{"type":"string","pattern":"^wpr1-[0-9a-f]{16}$"},"workflowId":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","const":"completed"},"automaticExecutionAllowed":{"type":"boolean","const":false},"externalActionIncluded":{"type":"boolean","const":false},"createdAt":{"type":"string","format":"date-time"},"toolSteps":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["order","toolSlug","source","completedAt"],"properties":{"order":{"type":"integer","minimum":1,"maximum":20},"toolSlug":{"type":"string","minLength":1,"maxLength":80},"source":{"type":"string","enum":["process_complete","download","calculate","manual"]},"completedAt":{"type":"string","format":"date-time"}}}},"inputContinuity":{"type":"object","additionalProperties":false,"required":["verifiedTransitions","totalTransitions","digestExposed","cryptographicallyAttested","serverReceivedFiles","transitions"],"properties":{"verifiedTransitions":{"type":"integer","minimum":0,"maximum":19},"totalTransitions":{"type":"integer","minimum":0,"maximum":19},"digestExposed":{"type":"boolean","const":false},"cryptographicallyAttested":{"type":"boolean","const":false},"serverReceivedFiles":{"type":"boolean","const":false},"transitions":{"type":"array","maxItems":19,"items":{"oneOf":[{"type":"object","additionalProperties":false,"required":["fromOrder","fromToolSlug","toOrder","toToolSlug","status","proof","verifiedAt"],"properties":{"fromOrder":{"type":"integer","minimum":1,"maximum":19},"fromToolSlug":{"type":"string","minLength":1,"maxLength":80},"toOrder":{"type":"integer","minimum":2,"maximum":20},"toToolSlug":{"type":"string","minLength":1,"maxLength":80},"status":{"type":"string","const":"verified-browser-local"},"proof":{"type":"string","const":"browser-local-sha256-match"},"verifiedAt":{"type":"string","format":"date-time"}}},{"type":"object","additionalProperties":false,"required":["fromOrder","fromToolSlug","toOrder","toToolSlug","status","proof","verifiedAt"],"properties":{"fromOrder":{"type":"integer","minimum":1,"maximum":19},"fromToolSlug":{"type":"string","minLength":1,"maxLength":80},"toOrder":{"type":"integer","minimum":2,"maximum":20},"toToolSlug":{"type":"string","minLength":1,"maxLength":80},"status":{"type":"string","const":"not-proven"},"proof":{"type":"string","const":"none"},"verifiedAt":{"type":"null"}}}]}}}},"finalReview":{"type":"object","additionalProperties":false,"required":["checklistItemCount","confirmedAt","confirmedBy"],"properties":{"checklistItemCount":{"type":"integer","minimum":1,"maximum":50},"confirmedAt":{"type":"string","format":"date-time"},"confirmedBy":{"type":"string","const":"user"}}},"privacy":{"type":"object","additionalProperties":false,"required":["serverStored","filesIncluded","fileNamesIncluded","inputValuesIncluded","taskTextIncluded","checklistTextIncluded"],"properties":{"serverStored":{"type":"boolean","const":false},"filesIncluded":{"type":"boolean","const":false},"fileNamesIncluded":{"type":"boolean","const":false},"inputValuesIncluded":{"type":"boolean","const":false},"taskTextIncluded":{"type":"boolean","const":false},"checklistTextIncluded":{"type":"boolean","const":false}}},"trust":{"type":"object","additionalProperties":false,"required":["level","cryptographicallyAttested","externalSubmissionProven"],"properties":{"level":{"type":"string","const":"local-user-confirmed"},"cryptographicallyAttested":{"type":"boolean","const":false},"externalSubmissionProven":{"type":"boolean","const":false}}}}},"WorkflowProgressHandoffReceipt":{"type":"object","additionalProperties":false,"required":["schemaVersion","receiptType","receiptId","planId","planRevision","workflowId","stage","createdAt","progress","privacy","handoff","trust"],"properties":{"schemaVersion":{"type":"string","const":"1.0"},"receiptType":{"type":"string","const":"ainew.local-workflow-progress-handoff"},"receiptId":{"type":"string","minLength":1,"maxLength":220},"planId":{"type":"string","minLength":1,"maxLength":100},"planRevision":{"type":"string","pattern":"^wpr1-[0-9a-f]{16}$"},"workflowId":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","enum":["in_progress","review_required"]},"createdAt":{"type":"string","format":"date-time"},"progress":{"type":"object","additionalProperties":false,"required":["startedAt","updatedAt","completed","total","toolStepsCompletedAt","evidence","currentStep"],"properties":{"startedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completed":{"type":"integer","minimum":0,"maximum":20},"total":{"type":"integer","minimum":1,"maximum":20},"toolStepsCompletedAt":{"type":["string","null"],"format":"date-time"},"evidence":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["order","toolSlug","source","completedAt"],"properties":{"order":{"type":"integer","minimum":1,"maximum":20},"toolSlug":{"type":"string","minLength":1,"maxLength":80},"source":{"type":"string","enum":["process_complete","download","calculate","manual"]},"completedAt":{"type":"string","format":"date-time"}}}},"currentStep":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["order","toolSlug","executionUrl"],"properties":{"order":{"type":"integer","minimum":1,"maximum":20},"toolSlug":{"type":"string","minLength":1,"maxLength":80},"executionUrl":{"type":"string","format":"uri"}}}]}}},"privacy":{"type":"object","additionalProperties":false,"required":["serverStored","filesIncluded","fileNamesIncluded","inputValuesIncluded","taskTextIncluded","checklistTextIncluded"],"properties":{"serverStored":{"type":"boolean","const":false},"filesIncluded":{"type":"boolean","const":false},"fileNamesIncluded":{"type":"boolean","const":false},"inputValuesIncluded":{"type":"boolean","const":false},"taskTextIncluded":{"type":"boolean","const":false},"checklistTextIncluded":{"type":"boolean","const":false}}},"handoff":{"type":"object","additionalProperties":false,"required":["mode","snapshotOnly","restoresProgress","marksTaskComplete","externalActionAuthorized","automaticExecutionAllowed"],"properties":{"mode":{"type":"string","const":"user-downloaded-read-only"},"snapshotOnly":{"type":"boolean","const":true},"restoresProgress":{"type":"boolean","const":false},"marksTaskComplete":{"type":"boolean","const":false},"externalActionAuthorized":{"type":"boolean","const":false},"automaticExecutionAllowed":{"type":"boolean","const":false}}},"trust":{"type":"object","additionalProperties":false,"required":["level","cryptographicallyAttested","liveProgressProven"],"properties":{"level":{"type":"string","const":"local-user-exported-snapshot"},"cryptographicallyAttested":{"type":"boolean","const":false},"liveProgressProven":{"type":"boolean","const":false}}}}}}},"paths":{"/api/agent/v1/capabilities":{"get":{"operationId":"findAinewCapabilities","summary":"用途に合うツールまたはページ内ワークフロー能力を検索","parameters":[{"name":"q","in":"query","description":"URLに残ってよい公開・非機密の検索語だけを指定してください。私的な自然言語タスクはブラウザ内の /agent を使用します。原文は応答に含めず、q付き応答はno-storeです。","schema":{"type":"string","minLength":2,"maxLength":160}},{"name":"kind","in":"query","schema":{"type":"string","enum":["tool","workflow"]}},{"name":"category","in":"query","schema":{"type":"string","enum":["pdf","image","finance","text","video","utility"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"能力候補","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","query","queryProvided","kind","category","count","items","attribution"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"query":{"type":"null","description":"Raw search text is accepted for ranking but never echoed."},"queryProvided":{"type":"boolean"},"kind":{"type":["string","null"],"enum":["tool","workflow",null]},"category":{"type":["string","null"]},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","kind","title","description","category","tags","usageScenes","inputTypes","outputTypes","capability","source","reason","executionUrl"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["tool","workflow"]},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["pdf","image","finance","text","video","utility"]},"tags":{"type":"array","items":{"type":"string"}},"usageScenes":{"type":"array","items":{"type":"string"}},"inputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"outputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"capability":{"type":"object","additionalProperties":false,"required":["schemaVersion","source","workbench","processing","execution","resultAssurance"],"properties":{"schemaVersion":{"type":"string","const":"1.1"},"source":{"type":"object","properties":{"input":{"type":"string","enum":["declared","inferred"]},"output":{"type":"string","enum":["declared","inferred"]}},"required":["input","output"],"additionalProperties":false},"workbench":{"type":"string"},"processing":{"type":"object","additionalProperties":false,"required":["location","heavyRuntime","cancellable","supportsBatch"],"properties":{"location":{"type":"string","enum":["browser-local","server-opt-in"]},"heavyRuntime":{"type":["string","null"]},"cancellable":{"type":"boolean"},"supportsBatch":{"type":"boolean"}}},"execution":{"type":"object","additionalProperties":false,"required":["mode","toolName","sideEffect","sideEffectSource","requiresUserFileSelection","requiresUserConfirmation"],"properties":{"mode":{"type":"string","enum":["discovery-only","page-local"]},"toolName":{"type":["string","null"]},"sideEffect":{"type":"string","enum":["none","local-download","unknown"]},"sideEffectSource":{"type":"string","enum":["declared","inferred"]},"requiresUserFileSelection":{"type":"boolean"},"requiresUserConfirmation":{"type":"boolean"}}},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}},"source":{"type":"object","additionalProperties":false,"properties":{"toolSlug":{"type":"string"},"workflowId":{"type":"string"},"capabilityName":{"type":"string"}}},"reason":{"type":["string","null"],"enum":["keyword","target","tag","title","format","scene","description","related","workflow_intent",null]},"executionUrl":{"type":"string","format":"uri"}}}},"attribution":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"不正な入力","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/capabilities/{id}":{"get":{"operationId":"getAinewCapability","summary":"能力の入出力、実行境界、実行ページURLを取得","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"能力情報","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","capability","attribution"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"capability":{"type":"object","additionalProperties":false,"required":["id","kind","title","description","category","tags","usageScenes","inputTypes","outputTypes","capability","source","reason","executionUrl"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["tool","workflow"]},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["pdf","image","finance","text","video","utility"]},"tags":{"type":"array","items":{"type":"string"}},"usageScenes":{"type":"array","items":{"type":"string"}},"inputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"outputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"capability":{"type":"object","additionalProperties":false,"required":["schemaVersion","source","workbench","processing","execution","resultAssurance"],"properties":{"schemaVersion":{"type":"string","const":"1.1"},"source":{"type":"object","properties":{"input":{"type":"string","enum":["declared","inferred"]},"output":{"type":"string","enum":["declared","inferred"]}},"required":["input","output"],"additionalProperties":false},"workbench":{"type":"string"},"processing":{"type":"object","additionalProperties":false,"required":["location","heavyRuntime","cancellable","supportsBatch"],"properties":{"location":{"type":"string","enum":["browser-local","server-opt-in"]},"heavyRuntime":{"type":["string","null"]},"cancellable":{"type":"boolean"},"supportsBatch":{"type":"boolean"}}},"execution":{"type":"object","additionalProperties":false,"required":["mode","toolName","sideEffect","sideEffectSource","requiresUserFileSelection","requiresUserConfirmation"],"properties":{"mode":{"type":"string","enum":["discovery-only","page-local"]},"toolName":{"type":["string","null"]},"sideEffect":{"type":"string","enum":["none","local-download","unknown"]},"sideEffectSource":{"type":"string","enum":["declared","inferred"]},"requiresUserFileSelection":{"type":"boolean"},"requiresUserConfirmation":{"type":"boolean"}}},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}},"source":{"type":"object","additionalProperties":false,"properties":{"toolSlug":{"type":"string"},"workflowId":{"type":"string"},"capabilityName":{"type":"string"}}},"reason":{"type":["string","null"],"enum":["keyword","target","tag","title","format","scene","description","related","workflow_intent",null]},"executionUrl":{"type":"string","format":"uri"}}},"attribution":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"能力が見つからない","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/composition":{"get":{"operationId":"getAinewCompositionGraph","summary":"明示准入されたブラウザ内ツールの安全な組み合わせ図を取得","description":"自由文、ファイル、ツール順、実行パラメータを受け取らず、明示singleton I/Oが完全一致する辺だけを返します。これは計画用メタデータであり、ツール実行、ファイル接力、ダウンロード、外部操作、入力連続性の証明を行いません。","parameters":[],"responses":{"200":{"description":"ブラウザ内ツールの安全な組み合わせ図","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","graphSchemaVersion","graphId","nodeCount","edgeCount","nodes","edges","policy","execution","attribution"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"graphSchemaVersion":{"type":"string","const":"1.0"},"graphId":{"type":"string","const":"ainew-browser-local-composition"},"nodeCount":{"type":"integer","minimum":1},"edgeCount":{"type":"integer","minimum":1},"nodes":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["slug","capabilitySchemaVersion","title","description","inputType","outputType","executionUrl","processingLocation","workbench","cancellable","sideEffect","requiresUserFileSelection","requiresUserConfirmation","resultAssurance"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"capabilitySchemaVersion":{"type":"string","const":"1.1"},"title":{"type":"string"},"description":{"type":"string"},"inputType":{"type":"string","enum":["pdf","image","heic","video","audio","text","docx","xlsx","zip","json","csv","number","date","url"]},"outputType":{"type":"string","enum":["pdf","image","heic","video","audio","text","docx","xlsx","zip","json","csv","number","date","url"]},"executionUrl":{"type":"string","format":"uri"},"processingLocation":{"type":"string","const":"browser-local"},"workbench":{"type":"string","enum":["file-single","file-batch","text-immediate","calculator-immediate","media-long-running","editor-persistent","guided-multistep"]},"cancellable":{"type":"boolean"},"sideEffect":{"type":"string","enum":["none","local-download"]},"requiresUserFileSelection":{"type":"boolean"},"requiresUserConfirmation":{"type":"boolean"},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}}},"edges":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["sourceToolSlug","targetToolSlug","dataType","compatible","handoffMode","automaticHandoffAllowed","inputContinuityProvenByPlan","userConfirmationRequired"],"properties":{"sourceToolSlug":{"type":"string"},"targetToolSlug":{"type":"string"},"dataType":{"type":"string","enum":["pdf","image","heic","video","audio","text","docx","xlsx","zip","json","csv","number","date","url"]},"compatible":{"type":"boolean","const":true},"handoffMode":{"type":"string","enum":["user-confirmed-browser-local-or-manual","manual-save-and-reselect"]},"automaticHandoffAllowed":{"type":"boolean","const":false},"inputContinuityProvenByPlan":{"type":"boolean","const":false},"userConfirmationRequired":{"type":"boolean","const":true}}}},"policy":{"type":"object","additionalProperties":false,"required":["planningOnly","fixedWorkflowPreferred","browserLocalOnly","minimumSteps","maximumSteps","uniqueToolsRequired","declaredSingletonInputOutputRequired","sequencePolicy","pageOpenCountsAsCompletion","completedStepReexecutionInvalidatesSuccessors","automaticExecutionAllowed","automaticHandoffAllowed","externalActionsSupported","userConfirmationRequiredForEveryTransition","finalUserReviewRequired","taskTextAccepted","filesAccepted","executionParametersAccepted","serverStoresPlanState"],"properties":{"planningOnly":{"type":"boolean","const":true},"fixedWorkflowPreferred":{"type":"boolean","const":true},"browserLocalOnly":{"type":"boolean","const":true},"minimumSteps":{"type":"integer","const":2},"maximumSteps":{"type":"integer","const":4},"uniqueToolsRequired":{"type":"boolean","const":true},"declaredSingletonInputOutputRequired":{"type":"boolean","const":true},"sequencePolicy":{"type":"string","const":"strict-prefix"},"pageOpenCountsAsCompletion":{"type":"boolean","const":false},"completedStepReexecutionInvalidatesSuccessors":{"type":"boolean","const":true},"automaticExecutionAllowed":{"type":"boolean","const":false},"automaticHandoffAllowed":{"type":"boolean","const":false},"externalActionsSupported":{"type":"boolean","const":false},"userConfirmationRequiredForEveryTransition":{"type":"boolean","const":true},"finalUserReviewRequired":{"type":"boolean","const":true},"taskTextAccepted":{"type":"boolean","const":false},"filesAccepted":{"type":"boolean","const":false},"executionParametersAccepted":{"type":"boolean","const":false},"serverStoresPlanState":{"type":"boolean","const":false}}},"execution":{"type":"object","additionalProperties":false,"required":["agentPageUrl","instruction"],"properties":{"agentPageUrl":{"type":"string","format":"uri"},"instruction":{"type":"string"}}},"attribution":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"自由文または未対応パラメータ","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/plans":{"get":{"operationId":"listAinewTaskPlans","summary":"既存ワークフローから安全な複数ツール計画を取得","description":"自由文やファイルを受け取らず、既存workflow IDから派生したガイド専用計画を返します。ツール実行、ダウンロード、アップロード、送信、外部提出は行いません。","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":50}}],"responses":{"200":{"description":"安全なタスク計画一覧","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","count","items","policy"],"properties":{"schemaVersion":{"type":"string","const":"1.7"},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","planId","planRevision","title","description","outcome","targetUser","category","mode","stepCount","automaticExecutionAllowed","detailUrl","executionUrl"],"properties":{"id":{"type":"string"},"planId":{"type":"string"},"planRevision":{"type":"string","pattern":"^wpr1-[0-9a-f]{16}$"},"title":{"type":"string"},"description":{"type":"string"},"outcome":{"type":"string"},"targetUser":{"type":"string"},"category":{"type":"string","enum":["pdf","image","video","text","finance","utility"]},"mode":{"type":"string","const":"guided-browser-local"},"stepCount":{"type":"integer","minimum":1},"automaticExecutionAllowed":{"type":"boolean","const":false},"detailUrl":{"type":"string","format":"uri"},"executionUrl":{"type":"string","format":"uri"}}}},"policy":{"type":"object","additionalProperties":false,"required":["acceptsFreeTextTask","acceptsFiles","storesState","automaticExecutionAllowed","externalActionsSupported"],"properties":{"acceptsFreeTextTask":{"type":"boolean","const":false},"acceptsFiles":{"type":"boolean","const":false},"storesState":{"type":"boolean","const":false},"automaticExecutionAllowed":{"type":"boolean","const":false},"externalActionsSupported":{"type":"boolean","const":false}}}}}}}},"400":{"description":"不正な入力または自由文パラメータ","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/plans/{workflowId}":{"get":{"operationId":"getAinewTaskPlan","summary":"複数ツール計画と確認・復旧境界を取得","description":"サービス側では状態を保存しません。工程はstrict-prefixで、前の工程が完了するまで次の工程の新しい完成証拠を受理しません。実行ページは30日間のブラウザ内進捗を読み取り専用WebMCPツールとして公開し、現在の工程で発生した実際のツール成功イベントだけを完成証拠にします。","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ガイド専用タスク計画","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","id","planId","planRevision","stage","mode","title","description","outcome","targetUser","category","source","automaticExecutionAllowed","sequence","steps","completion","privacy","externalActions","recovery"],"properties":{"schemaVersion":{"type":"string","const":"1.7"},"id":{"type":"string"},"planId":{"type":"string"},"planRevision":{"type":"string","pattern":"^wpr1-[0-9a-f]{16}$"},"stage":{"type":"string","const":"draft"},"mode":{"type":"string","const":"guided-browser-local"},"title":{"type":"string"},"description":{"type":"string"},"outcome":{"type":"string"},"targetUser":{"type":"string"},"category":{"type":"string","enum":["pdf","image","video","text","finance","utility"]},"source":{"type":"object","additionalProperties":false,"required":["workflowId","executionUrl","pageLocalProgressToolName"],"properties":{"workflowId":{"type":"string"},"executionUrl":{"type":"string","format":"uri"},"pageLocalProgressToolName":{"type":"string"}}},"automaticExecutionAllowed":{"type":"boolean","const":false},"sequence":{"type":"object","additionalProperties":false,"required":["policy","pageOpenCountsAsCompletion","outOfOrderCompletionAccepted","completedStepReexecutionAllowed","completedStepReexecutionInvalidatesSuccessors"],"properties":{"policy":{"type":"string","const":"strict-prefix"},"pageOpenCountsAsCompletion":{"type":"boolean","const":false},"outOfOrderCompletionAccepted":{"type":"boolean","const":false},"completedStepReexecutionAllowed":{"type":"boolean","const":true},"completedStepReexecutionInvalidatesSuccessors":{"type":"boolean","const":true}}},"steps":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["id","order","title","description","sequence","capability","execution","confirmation","verification","recovery"],"properties":{"id":{"type":"string"},"order":{"type":"integer","minimum":1},"title":{"type":"string"},"description":{"type":"string"},"sequence":{"type":"object","additionalProperties":false,"required":["policy","prerequisiteStepIds","completionAcceptedOnlyWhenCurrent"],"properties":{"policy":{"type":"string","const":"strict-prefix"},"prerequisiteStepIds":{"type":"array","uniqueItems":true,"items":{"type":"string"}},"completionAcceptedOnlyWhenCurrent":{"type":"boolean","const":true}}},"capability":{"type":"object","additionalProperties":false,"required":["id","version","inputTypes","outputTypes","source","workbench","processingLocation","cancellable","supportsBatch","resultAssurance"],"properties":{"id":{"type":"string"},"version":{"type":"string","const":"1.1"},"inputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"outputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"source":{"type":"object","additionalProperties":false,"required":["input","output"],"properties":{"input":{"type":"string","enum":["declared","inferred"]},"output":{"type":"string","enum":["declared","inferred"]}}},"workbench":{"type":"string"},"processingLocation":{"type":"string","enum":["browser-local","server-opt-in"]},"cancellable":{"type":"boolean"},"supportsBatch":{"type":"boolean"},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}},"execution":{"type":"object","additionalProperties":false,"required":["mode","url","pageLocalToolName","sideEffect","sideEffectSource","requiresUserConfirmation","automaticAllowed"],"properties":{"mode":{"type":"string","const":"user-guided-page"},"url":{"type":"string","format":"uri"},"pageLocalToolName":{"type":["string","null"]},"sideEffect":{"type":"string","enum":["none","local-download","unknown"]},"sideEffectSource":{"type":"string","enum":["declared","inferred"]},"requiresUserConfirmation":{"type":"boolean"},"automaticAllowed":{"type":"boolean","const":false}}},"confirmation":{"type":"object","additionalProperties":false,"required":["requiredUserActions","beforeFileSelection","beforeResultAction","externalActionCovered"],"properties":{"requiredUserActions":{"type":"array","minItems":2,"items":{"type":"string","enum":["select-file-in-browser","provide-input-in-browser","review-result","confirm-result-action"]}},"beforeFileSelection":{"type":"boolean"},"beforeResultAction":{"type":"boolean"},"externalActionCovered":{"type":"boolean","const":false}}},"verification":{"type":"object","additionalProperties":false,"required":["required","owner","evidence","resultContentIncluded","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven"],"properties":{"required":{"type":"boolean","const":true},"owner":{"type":"string","const":"user"},"evidence":{"type":"string","const":"tool-lifecycle-success"},"resultContentIncluded":{"type":"boolean","const":false},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false}}},"recovery":{"type":"object","additionalProperties":false,"required":["retryUrl","inputPreservedByPlan","automaticFileHandoff"],"properties":{"retryUrl":{"type":"string","format":"uri"},"inputPreservedByPlan":{"type":"boolean","const":false},"automaticFileHandoff":{"type":"boolean","const":false}}}}}},"completion":{"type":"object","additionalProperties":false,"required":["requiresUserReview","checklist","successRequiresFinalReviewConfirmation","toolStepsAloneCountAsSuccess","externalSubmissionIncluded","downloadableReceipt"],"properties":{"requiresUserReview":{"type":"boolean","const":true},"checklist":{"type":"array","items":{"type":"string"}},"successRequiresFinalReviewConfirmation":{"type":"boolean","const":true},"toolStepsAloneCountAsSuccess":{"type":"boolean","const":false},"externalSubmissionIncluded":{"type":"boolean","const":false},"downloadableReceipt":{"type":"object","additionalProperties":false,"required":["availableAfterFinalReview","receiptType","schemaVersion","schemaRef","format","generatedInBrowser","taskTextIncluded","inputValuesIncluded","cryptographicallyAttested","externalSubmissionProven","verification"],"properties":{"availableAfterFinalReview":{"type":"boolean","const":true},"receiptType":{"type":"string","const":"ainew.local-workflow-completion"},"schemaVersion":{"type":"string","const":"1.2"},"schemaRef":{"type":"string","format":"uri","const":"https://tools.ainew.jp/openapi.json#/components/schemas/WorkflowCompletionReceipt"},"format":{"type":"string","const":"application/json"},"generatedInBrowser":{"type":"boolean","const":true},"taskTextIncluded":{"type":"boolean","const":false},"inputValuesIncluded":{"type":"boolean","const":false},"cryptographicallyAttested":{"type":"boolean","const":false},"externalSubmissionProven":{"type":"boolean","const":false},"verification":{"type":"object","additionalProperties":false,"required":["url","mode","uploadsReceipt","storesReceipt","restoresProgress","marksTaskComplete","externalActionAuthorized"],"properties":{"url":{"type":"string","format":"uri","const":"https://tools.ainew.jp/agent#completion-receipt-verifier"},"mode":{"type":"string","const":"browser-local-read-only"},"uploadsReceipt":{"type":"boolean","const":false},"storesReceipt":{"type":"boolean","const":false},"restoresProgress":{"type":"boolean","const":false},"marksTaskComplete":{"type":"boolean","const":false},"externalActionAuthorized":{"type":"boolean","const":false}}}}}}},"privacy":{"type":"object","additionalProperties":false,"required":["serverAcceptsFiles","serverStoresPlanState","freeTextTaskAccepted","fileNamesIncluded","fileContentsIncluded"],"properties":{"serverAcceptsFiles":{"type":"boolean","const":false},"serverStoresPlanState":{"type":"boolean","const":false},"freeTextTaskAccepted":{"type":"boolean","const":false},"fileNamesIncluded":{"type":"boolean","const":false},"fileContentsIncluded":{"type":"boolean","const":false}}},"externalActions":{"type":"object","additionalProperties":false,"required":["supported","automaticAllowed","userMustCompleteOutsideAinew"],"properties":{"supported":{"type":"boolean","const":false},"automaticAllowed":{"type":"boolean","const":false},"userMustCompleteOutsideAinew":{"type":"boolean","const":true}}},"recovery":{"type":"object","additionalProperties":false,"required":["refetchable","restartUrl","serverPlanStateStored","localProgress"],"properties":{"refetchable":{"type":"boolean","const":true},"restartUrl":{"type":"string","format":"uri"},"serverPlanStateStored":{"type":"boolean","const":false},"localProgress":{"type":"object","additionalProperties":false,"required":["availableOnWorkflowPage","storage","webMcpToolName","retentionDays","userClearable","pageOpenCountsAsCompletion","completionEvidence","portableHandoff"],"properties":{"availableOnWorkflowPage":{"type":"boolean","const":true},"storage":{"type":"string","const":"browser-local"},"webMcpToolName":{"type":"string"},"retentionDays":{"type":"integer","const":30},"userClearable":{"type":"boolean","const":true},"pageOpenCountsAsCompletion":{"type":"boolean","const":false},"completionEvidence":{"type":"string","const":"tool-lifecycle-success-plus-final-user-review"},"portableHandoff":{"type":"object","additionalProperties":false,"required":["availableWhen","receiptType","schemaVersion","schemaRef","format","generatedInBrowser","snapshotOnly","taskTextIncluded","inputValuesIncluded","verification"],"properties":{"availableWhen":{"type":"array","minItems":2,"maxItems":2,"prefixItems":[{"type":"string","const":"in_progress"},{"type":"string","const":"review_required"}],"items":false},"receiptType":{"type":"string","const":"ainew.local-workflow-progress-handoff"},"schemaVersion":{"type":"string","const":"1.0"},"schemaRef":{"type":"string","format":"uri","const":"https://tools.ainew.jp/openapi.json#/components/schemas/WorkflowProgressHandoffReceipt"},"format":{"type":"string","const":"application/json"},"generatedInBrowser":{"type":"boolean","const":true},"snapshotOnly":{"type":"boolean","const":true},"taskTextIncluded":{"type":"boolean","const":false},"inputValuesIncluded":{"type":"boolean","const":false},"verification":{"type":"object","additionalProperties":false,"required":["url","mode","uploadsReceipt","storesReceipt","restoresProgress","marksTaskComplete","externalActionAuthorized","automaticExecutionAllowed"],"properties":{"url":{"type":"string","format":"uri","const":"https://tools.ainew.jp/agent#progress-handoff-verifier"},"mode":{"type":"string","const":"browser-local-read-only"},"uploadsReceipt":{"type":"boolean","const":false},"storesReceipt":{"type":"boolean","const":false},"restoresProgress":{"type":"boolean","const":false},"marksTaskComplete":{"type":"boolean","const":false},"externalActionAuthorized":{"type":"boolean","const":false},"automaticExecutionAllowed":{"type":"boolean","const":false}}}}}}}}}}}}}},"404":{"description":"計画が見つからない","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/tools":{"get":{"operationId":"findAinewTools","summary":"用途に合うブラウザツールを検索","parameters":[{"name":"q","in":"query","description":"URLに残ってよい公開・非機密の検索語だけを指定してください。原文は応答に含めず、q付き応答はno-storeです。","schema":{"type":"string","minLength":2,"maxLength":160}},{"name":"category","in":"query","schema":{"type":"string","enum":["pdf","image","finance","text","video","utility"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"ツール候補","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","query","queryProvided","category","count","items","attribution"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"query":{"type":"null","description":"Raw search text is accepted for ranking but never echoed."},"queryProvided":{"type":"boolean"},"category":{"type":["string","null"]},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["slug","title","description","category","inputTypes","outputTypes","processing","capability","url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["pdf","image","finance","text","video","utility"]},"tags":{"type":"array","items":{"type":"string"}},"inputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"outputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"usageScenes":{"type":"array","items":{"type":"string"}},"webMcp":{"type":"boolean"},"processing":{"type":"string","const":"browser-local"},"capability":{"type":"object","additionalProperties":false,"required":["schemaVersion","source","workbench","processing","execution","resultAssurance"],"properties":{"schemaVersion":{"type":"string","const":"1.1"},"source":{"type":"object","properties":{"input":{"type":"string","enum":["declared","inferred"]},"output":{"type":"string","enum":["declared","inferred"]}},"required":["input","output"],"additionalProperties":false},"workbench":{"type":"string"},"processing":{"type":"object","additionalProperties":false,"required":["location","heavyRuntime","cancellable","supportsBatch"],"properties":{"location":{"type":"string","enum":["browser-local","server-opt-in"]},"heavyRuntime":{"type":["string","null"]},"cancellable":{"type":"boolean"},"supportsBatch":{"type":"boolean"}}},"execution":{"type":"object","additionalProperties":false,"required":["mode","toolName","sideEffect","sideEffectSource","requiresUserFileSelection","requiresUserConfirmation"],"properties":{"mode":{"type":"string","enum":["discovery-only","page-local"]},"toolName":{"type":["string","null"]},"sideEffect":{"type":"string","enum":["none","local-download","unknown"]},"sideEffectSource":{"type":"string","enum":["declared","inferred"]},"requiresUserFileSelection":{"type":"boolean"},"requiresUserConfirmation":{"type":"boolean"}}},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}},"reason":{"type":["string","null"],"enum":["keyword","target","tag","title","format","scene","description","related",null]},"url":{"type":"string","format":"uri"}}}},"attribution":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"不正な入力","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}},"/api/agent/v1/tools/{slug}":{"get":{"operationId":"getAinewTool","summary":"ツールの説明と実行ページURLを取得","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ツール情報","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","tool","attribution"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"tool":{"type":"object","additionalProperties":false,"required":["slug","title","description","category","inputTypes","outputTypes","processing","capability","url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["pdf","image","finance","text","video","utility"]},"tags":{"type":"array","items":{"type":"string"}},"inputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"outputTypes":{"type":"array","minItems":1,"items":{"type":"string"}},"usageScenes":{"type":"array","items":{"type":"string"}},"webMcp":{"type":"boolean"},"processing":{"type":"string","const":"browser-local"},"capability":{"type":"object","additionalProperties":false,"required":["schemaVersion","source","workbench","processing","execution","resultAssurance"],"properties":{"schemaVersion":{"type":"string","const":"1.1"},"source":{"type":"object","properties":{"input":{"type":"string","enum":["declared","inferred"]},"output":{"type":"string","enum":["declared","inferred"]}},"required":["input","output"],"additionalProperties":false},"workbench":{"type":"string"},"processing":{"type":"object","additionalProperties":false,"required":["location","heavyRuntime","cancellable","supportsBatch"],"properties":{"location":{"type":"string","enum":["browser-local","server-opt-in"]},"heavyRuntime":{"type":["string","null"]},"cancellable":{"type":"boolean"},"supportsBatch":{"type":"boolean"}}},"execution":{"type":"object","additionalProperties":false,"required":["mode","toolName","sideEffect","sideEffectSource","requiresUserFileSelection","requiresUserConfirmation"],"properties":{"mode":{"type":"string","enum":["discovery-only","page-local"]},"toolName":{"type":["string","null"]},"sideEffect":{"type":"string","enum":["none","local-download","unknown"]},"sideEffectSource":{"type":"string","enum":["declared","inferred"]},"requiresUserFileSelection":{"type":"boolean"},"requiresUserConfirmation":{"type":"boolean"}}},"resultAssurance":{"type":"object","additionalProperties":false,"required":["evidence","agentReceivesStructuredResult","resultCheckedAgainstDeclaredConstraints","cryptographicallyAttested","downstreamInputContinuityProven","externalOutcomeProven","userReviewRequired"],"properties":{"evidence":{"type":"string","enum":["none","browser-local-structured-result","browser-local-structured-inspection"]},"agentReceivesStructuredResult":{"type":"boolean"},"resultCheckedAgainstDeclaredConstraints":{"type":"boolean"},"cryptographicallyAttested":{"type":"boolean","const":false},"downstreamInputContinuityProven":{"type":"boolean","const":false},"externalOutcomeProven":{"type":"boolean","const":false},"userReviewRequired":{"type":"boolean","const":true}}}}},"reason":{"type":["string","null"],"enum":["keyword","target","tag","title","format","scene","description","related",null]},"url":{"type":"string","format":"uri"}}},"attribution":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"ツールが見つからない","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","error","code","retryable"],"properties":{"schemaVersion":{"type":"string","const":"1.4"},"error":{"type":"string"},"code":{"type":"string","enum":["invalid_query","invalid_kind","invalid_category","invalid_limit","unsupported_parameter","capability_not_found","plan_not_found","tool_not_found"]},"retryable":{"type":"boolean","const":false}}}}}}}}}}}