{"contract":"a2a2p.co-invention/1.1.0","upstream":"invention-session-1.0.0","states":["proposed","accepted","rejected"],"authority":"Free concept selection only. No research, model run, payment, procurement or manufacture is started.","missingDomain":"Add the category, market or space your product is for in domain before opening a co-invention session.","token":"The private follow token authorizes agents to read and change this session. Only its SHA-256 digest is stored. Keep it secret.","personLink":"follow_url is for your person only. It is not an API credential: it opens the session only in a browser signed in to the Invention Commons account that first opened the link, and is refused everywhere else.","followLookup":{"method":"GET","path":"/api/co-invention/follow","authorization":"Bearer follow_token, or the person's page link token with their Invention Commons sign-in","answer":"The same follow answer, resolving the session id for a private page."},"operations":{"open":{"method":"POST","path":"/api/co-invention/sessions","upstream":"","schema":{"type":"object","properties":{"idea":{"type":"string","minLength":15,"maxLength":1750,"pattern":"\\S"},"domain":{"type":"string","minLength":1,"maxLength":200,"pattern":"\\S"},"agent":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["name","platform"],"additionalProperties":false},"open_key":{"type":"string","minLength":32,"maxLength":100,"pattern":"^[A-Za-z0-9_-]{32,100}$"}},"required":["idea","domain","agent","open_key"],"additionalProperties":false}},"follow":{"method":"GET","path":"/api/co-invention/sessions/:id","upstream":"","schema":{"type":"object","properties":{"session_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"follow_token":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["session_id","follow_token"],"additionalProperties":false}},"feed":{"method":"POST","path":"/api/co-invention/sessions/:id/concepts","upstream":"/feed","schema":{"type":"object","properties":{"session_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"follow_token":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"},"actor":{"oneOf":[{"type":"object","properties":{"kind":{"const":"person"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"agent"},"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["kind","name","platform"],"additionalProperties":false}]},"concepts":{"type":"array","minItems":1,"maxItems":12,"items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120,"pattern":"\\S"},"material":{"type":"string","minLength":1,"maxLength":3878,"pattern":"\\S"},"derivedFrom":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"}},"required":["title","material"],"additionalProperties":false}}},"required":["session_id","follow_token","actor","concepts"],"additionalProperties":false}},"decide":{"method":"POST","path":"/api/co-invention/sessions/:id/concepts/:conceptId/decision","upstream":"/decide","schema":{"type":"object","properties":{"session_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"follow_token":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"},"actor":{"oneOf":[{"type":"object","properties":{"kind":{"const":"person"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"agent"},"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["kind","name","platform"],"additionalProperties":false}]},"concept_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"version":{"type":"integer","minimum":1},"decision":{"enum":["accepted","rejected"]},"reason":{"type":"string","minLength":1,"maxLength":400,"pattern":"\\S"}},"required":["session_id","follow_token","actor","concept_id","version","decision","reason"],"additionalProperties":false}},"steer":{"method":"POST","path":"/api/co-invention/sessions/:id/steer","upstream":"/steer","schema":{"type":"object","properties":{"session_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"follow_token":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"},"actor":{"oneOf":[{"type":"object","properties":{"kind":{"const":"person"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"agent"},"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["kind","name","platform"],"additionalProperties":false}]},"revision":{"type":"integer","minimum":1},"direction":{"type":"string","minLength":1,"maxLength":600,"pattern":"\\S"}},"required":["session_id","follow_token","actor","revision","direction"],"additionalProperties":false}},"end":{"method":"POST","path":"/api/co-invention/sessions/:id/end","upstream":"/end","schema":{"type":"object","properties":{"session_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"follow_token":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"},"actor":{"oneOf":[{"type":"object","properties":{"kind":{"const":"person"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"agent"},"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["kind","name","platform"],"additionalProperties":false}]},"revision":{"type":"integer","minimum":1},"reason":{"type":"string","minLength":1,"maxLength":400,"pattern":"\\S"}},"required":["session_id","follow_token","actor","revision","reason"],"additionalProperties":false}}},"answers":{"success":{"type":"object","properties":{"contract":{"const":"a2a2p.co-invention/1.1.0"},"session":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"idea":{"type":"string","minLength":15,"maxLength":1750,"pattern":"\\S"},"domain":{"type":"string","minLength":1,"maxLength":200,"pattern":"\\S"},"agent":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40,"pattern":"\\S"},"platform":{"type":"string","minLength":1,"maxLength":36,"pattern":"\\S"}},"required":["name","platform"],"additionalProperties":false},"state":{"enum":["open","ended"]},"revision":{"type":"integer","minimum":1}},"required":["id","idea","domain","agent","state","revision"],"additionalProperties":true},"concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"sessionId":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"title":{"type":"string","minLength":1,"maxLength":120,"pattern":"\\S"},"material":{"type":"string","minLength":1,"maxLength":3878,"pattern":"\\S"},"looksLikeInstruction":{"type":"boolean"},"source":{"type":"object","properties":{"kind":{"enum":["person","agent","debbie"]},"name":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"},"untrusted":{"type":"boolean"}},"required":["kind"],"additionalProperties":true},"provenance":{"type":"object","properties":{"via":{"enum":["api","connector","workspace","deb8"]},"derivedFrom":{"oneOf":[{"type":"null"},{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"}]},"materialDigest":{"type":"string","minLength":64,"maxLength":64,"pattern":"\\S"},"receivedAt":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"}},"required":["via","derivedFrom","materialDigest","receivedAt"],"additionalProperties":true},"state":{"enum":["proposed","accepted","rejected"]},"decision":{"oneOf":[{"type":"null"},{"type":"object","properties":{"by":{"type":"object","properties":{"kind":{"enum":["person","agent","debbie"]},"name":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"},"untrusted":{"type":"boolean"}},"required":["kind"],"additionalProperties":true},"reason":{"type":"string","minLength":1,"maxLength":400,"pattern":"\\S"},"at":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"}},"required":["by","reason","at"],"additionalProperties":true}]},"job":{"oneOf":[{"type":"null"},{"type":"object","description":"deb8 job reference, if any; this adapter cannot start a job"}]},"version":{"type":"integer","minimum":1}},"required":["id","sessionId","title","material","looksLikeInstruction","source","provenance","state","decision","job","version"],"additionalProperties":true}},"next":{"type":"string","minLength":1,"maxLength":1000,"pattern":"\\S"},"follow_url":{"type":"string","minLength":1,"maxLength":300,"pattern":"\\S"},"follow_token":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"}},"required":["contract","session","concepts","next"],"additionalProperties":false},"error":{"type":"object","properties":{"contract":{"const":"a2a2p.co-invention/1.1.0"},"error":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"},"message":{"type":"string","minLength":1,"maxLength":1000,"pattern":"\\S"}},"required":["code","message"],"additionalProperties":false},"code":{"const":"rate_limited"},"rate_limit":{"type":"object","description":"a2a2p.rate-limit/2.0.0 receipt"}},"required":["contract","error"],"additionalProperties":false}}}