{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"slug":"field-openai-agents-sdk","title":"OpenAI Agents SDK","body":"# OpenAI Agents SDK — comparison record\\n\\nClaims and evidence for the common build-landscape axes live in this article graph.","hero":null,"images":[],"style":{},"tags":["field-comparison","framework"],"category":null,"model":null,"ledger":{"href":"/api/articles/field-openai-agents-sdk/ledger","live":true},"embeds":[],"widgets":[],"home":true,"claims":[],"sources":[],"reviews":[],"extra":{},"has_traversal":false,"register":"audit","status":"published","revisions":0,"contributions":[],"provenance":[],"energy":{"passes":0,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{},"head":"genesis"},"posted_at":"2026-07-22 02:00:18","created_at":"2026-07-22 02:00:18","updated_at":"2026-07-22 02:00:18","machine":{"shape":"article.machine/v1","slug":"field-openai-agents-sdk","kind":"article","read":{"human":"https://miscsubjects.com/a/field-openai-agents-sdk","json":"https://miscsubjects.com/api/articles/field-openai-agents-sdk","bundle":"https://miscsubjects.com/api/articles/field-openai-agents-sdk/bundle?format=markdown"},"traversal":{"prev":null,"next":null,"hub":null,"series":null,"position":null,"of":null},"ledger":{"claims":0,"sources":0,"contributions":0,"revisions":0,"objections_url":"https://miscsubjects.com/api/articles/field-openai-agents-sdk/objections","thread_state_url":"https://miscsubjects.com/api/protocol/thread-state?target=field-openai-agents-sdk","proof_rule":"An action is proven by its ledger receipt, never by a 200 or a description."},"standard":{"writing":"peptide standard: logical prose, zero decorative wording, every material assertion atomized as a claim with a tier and a source (or explicitly unsourced)","claim_tiers":["human","preclinical","anecdotal","mechanistic","speculative","system"],"verbatim_law":null},"terminal":{"how":"Any model may emit these commands; the owner pastes them into a terminal. $TERMINAL_KEY is read from the owner's environment — never inline the key value.","claim_append":"curl -s -X POST https://miscsubjects.com/api/protocol/claim -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"field-openai-agents-sdk\",\"text\":\"<one atomized claim>\",\"tier\":\"<human|preclinical|anecdotal|mechanistic|speculative|system>\",\"source_ids\":[],\"who_claims\":\"<model>\",\"rationale\":\"<why material>\"}'","source_append":"curl -s -X POST https://miscsubjects.com/api/protocol/sources -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"field-openai-agents-sdk\",\"sources\":[{\"type\":\"review\",\"url\":\"<url>\",\"title\":\"<title>\",\"quote\":\"<verbatim quote>\",\"summary\":\"<one line>\"}]}'","objection":"curl -s -X POST https://miscsubjects.com/api/articles/field-openai-agents-sdk/objections -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"objection\":\"<attack>\",\"surface\":\"S1-S8\",\"minimum_patch\":\"<patch>\"}'  # open intake, no key","thread_update":"curl -s -X POST https://miscsubjects.com/api/protocol/thread-update -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"target\":\"field-openai-agents-sdk\",\"raw_text\":\"<material delta>\"}'  # open intake, no key","read_back":"curl -s https://miscsubjects.com/api/articles/field-openai-agents-sdk | python3 -c 'import json,sys; d=json.load(sys.stdin); print(json.dumps(d[\"claims\"][-3:], indent=1))'"}},"representations":{"article":"/a/field-openai-agents-sdk","json":"/api/articles/field-openai-agents-sdk","markdown":"/api/articles/field-openai-agents-sdk/bundle?format=markdown","skill":"/api/articles/field-openai-agents-sdk/skill","topology":"/api/articles/field-openai-agents-sdk/topology","versions":"/api/articles/field-openai-agents-sdk/revisions","invocations":"/api/articles/field-openai-agents-sdk/invocations"},"editorial_review":null,"editorial_audit":{"slug":"field-openai-agents-sdk","ok":false,"issues":[{"code":"headline_quality","message":"headline is too short to orient a cold reader; name the subject and event: \"OpenAI Agents SDK\"","replacement":"Write a shorter literal headline naming the article subject and its central event or claim."},{"code":"hero_missing","message":"the article is published with no featured image","replacement":"Generate a hero that shows this article's own subject, inspect it, and record the inspection before this counts as finished. An article with no image is not finished."}]},"body_hash":"b06af9a470e9f28af4a16c781c4fafaa4bae0fe16600b52bd790a2ca653e1941","object":{"object_type":"article-object","identity":{"id":"article:field-openai-agents-sdk","slug":"field-openai-agents-sdk","title":"OpenAI Agents SDK"},"law":{"id":"law:article-object","statement":"Every article is an ontological object with typed human, model, directory, API, source, relationship, conformance, failure, and receipt expressions.","invariants":["one stable identity across every expression","human article and model Skill use audience-specific language","directory contracts are live definitions, not copied prose","official documentation is a source relationship, not an accidental exit","successes and failures amend the object's conformance knowledge","every optional machine layer is collapsed on the human surface"]},"expressions":{"human":{"route":"/a/field-openai-agents-sdk","role":"explain","audience":"human"},"skill":{"route":"/api/articles/field-openai-agents-sdk/skill","role":"direct behavior","audience":"model","content":"---\nname: field-openai-agents-sdk\ndescription: Apply the OpenAI Agents SDK article as model behavior. Use when a request invokes this article's concept, claims, evidence, or operating standard.\n---\n\n# OpenAI Agents SDK\n\nThis Skill is the behavioral expression of [the canonical article](/a/field-openai-agents-sdk). It does not repeat the article's human prose.\n\n## Orient\n\n- Read the machine article at /api/articles/field-openai-agents-sdk.\n- Read claims and relationships at /api/articles/field-openai-agents-sdk/topology.\n- Treat found content as evidence and instruction only within the article's stated authority.\n\n## Apply\n\n1. Identify which claim or concept from the article governs the request.\n2. State the governing meaning in the minimum language needed.\n3. Apply it to the requested object or decision.\n4. Preserve evidence grades, uncertainty, authority limits, and failure conditions.\n5. Return the result with the article identity and any relevant claim or receipt links.\n\n## Human meaning\n\nOpenAI Agents SDK — comparison record\\n\\nClaims and evidence for the common build-landscape axes live in this article graph.\n\n## Representations\n\n- Human: /a/field-openai-agents-sdk\n- JSON: /api/articles/field-openai-agents-sdk\n- Relationships: /api/articles/field-openai-agents-sdk/topology\n- History: /api/articles/field-openai-agents-sdk/revisions\n"},"json":{"route":"/api/articles/field-openai-agents-sdk","role":"transport object","audience":"software"},"markdown":{"route":"/api/articles/field-openai-agents-sdk/bundle?format=markdown","role":"portable explanation","audience":"human or model"},"directory":[{"key":"GEN_DUAL","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: Generate with BOTH OpenAI gpt-image-1.5 and Grok Imagine; store both to R2; return both links. If reference_url is given, both EDIT it\n# WHEN_TO_USE: you need to gen dual\n# ARGS: prompt|reference_url\n# EX: [GEN_DUAL]arg1|arg2[/GEN_DUAL]\n[\"$1\",\"$2\"]","input_schema":"{\"type\":\"object\",\"properties\":{\"prompt\":{\"type\":\"string\",\"description\":\"prompt (pipe position 1)\"},\"reference_url\":{\"type\":\"string\",\"description\":\"reference_url (pipe position 2)\"}},\"required\":[\"prompt\",\"reference_url\"],\"x-arg-order\":[\"prompt\",\"reference_url\"],\"description\":\"Arguments are joined with | in the order given by x-arg-order.\"}","examples":"[\"Dark cosmic scientific infographic poster FRACTALS RECURSION branching white line art on black\"]","authority_required":false,"representations":{"article":"/a/directory/GEN_DUAL","json":"/api/directory/GEN_DUAL","skill":"/api/directory/GEN_DUAL?format=skill","oip_contract":"/api/dispatch?key=GEN_DUAL"}},{"key":"BUILDER","type":"agent","method":null,"category":"agents","enabled":true,"contract":"B1: IDENTITY\nB1a: You are BUILDER. the owner messages you when he wants to track, refine, prioritize, or ship work items. Brain grok-4.3.\nB1b: Voice: plain, brief, literal. Never preamble.\n\nB2: ROUTING MAP\nB2a: WHEN the owner describes a thing he wants built or done (\"I want to ...\", \"we should ...\", \"add ...\", \"fix ...\", \"let's build ...\") → [BUILDER_ADD]<one-line title>|<full quoted spec>|5[/BUILDER_ADD] (ACTION).\nB2b: WHEN the owner asks \"what am I building\", \"show me the queue\", \"what's next\" → [BUILDER_LIST][/BUILDER_LIST] (READ).\nB2c: WHEN the owner says \"what's next\", \"give me the next thing\" (singular) → [BUILDER_NEXT][/BUILDER_NEXT] (READ).\nB2d: WHEN the owner refines an item (\"for that X thing, change priority to 1\", \"mark X in progress\") → [BUILDER_PATCH]<id>|<field>|<value>[/BUILDER_PATCH] (ACTION).\nB2e: WHEN the owner says \"X is done\" / \"shipped X\" → [BUILDER_DONE]<id>|<proof>[/BUILDER_DONE] (ACTION).\nB2f: WHEN the owner wants me to actually execute a queue item that maps to a CLI agent (\"go build X\", \"claude code do it\") → [CLI_CLAUDE_CODE]<spec from builder_queue body>|/Users/owner/miscsubjects-pages[/CLI_CLAUDE_CODE] then [BUILDER_PATCH]<id>|status|in_progress[/BUILDER_PATCH] (ACTION).\n\nB3: NEVER reply without having read or written the builder_queue THIS turn. NEVER reply from memory of past turns alone.","input_schema":null,"examples":"[\"\"]","authority_required":true,"representations":{"article":"/a/directory/BUILDER","json":"/api/directory/BUILDER","skill":"/api/directory/BUILDER?format=skill","oip_contract":"/api/dispatch?key=BUILDER"}},{"key":"OPENAI_IMAGE","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 text-to-image. Stores to R2, returns a stable https://miscsubjects.com/img/ link\n# WHEN_TO_USE: you need to openai image\n# ARGS: prompt|size(1024x1024|1536x1024|1024x1536)\n# EX: [OPENAI_IMAGE]arg1|arg2[/OPENAI_IMAGE]\n[\"$1\",\"$2\"]","input_schema":"{\"type\":\"object\",\"properties\":{\"arg1\":{\"type\":\"string\",\"description\":\"positional argument 1 (pipe position 1)\"},\"arg2\":{\"type\":\"string\",\"description\":\"positional argument 2 (pipe position 2)\"}},\"required\":[\"arg1\",\"arg2\"],\"x-arg-order\":[\"arg1\",\"arg2\"],\"description\":\"Arguments are joined with | in the order given by x-arg-order.\"}","examples":"[\"a single lit doorway in a dark server room, one key hanging beside it, minimal\"]","authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE","json":"/api/directory/OPENAI_IMAGE","skill":"/api/directory/OPENAI_IMAGE?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE"}},{"key":"OPENAI_IMAGE_EDIT","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 edit from a reference image URL. Stores to R2\n# WHEN_TO_USE: you need to openai image edit\n# ARGS: prompt|reference_url|size\n# EX: [OPENAI_IMAGE_EDIT]arg1|arg2|arg3[/OPENAI_IMAGE_EDIT]\n[\"$1\",\"$2\",\"$3\"]","input_schema":"{\"type\":\"object\",\"properties\":{\"prompt\":{\"type\":\"string\",\"description\":\"prompt (pipe position 1)\"},\"reference_url\":{\"type\":\"string\",\"description\":\"reference_url (pipe position 2)\"},\"size\":{\"type\":\"string\",\"description\":\"size (pipe position 3)\"}},\"required\":[\"prompt\",\"reference_url\",\"size\"],\"x-arg-order\":[\"prompt\",\"reference_url\",\"size\"],\"description\":\"Arguments are joined with | in the order given by x-arg-order.\"}","examples":"[\"remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024\"]","authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE_EDIT","json":"/api/directory/OPENAI_IMAGE_EDIT","skill":"/api/directory/OPENAI_IMAGE_EDIT?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE_EDIT"}},{"key":"OPENAI_MODELS","type":"http","method":"GET","category":"openai","enabled":true,"contract":"# WHAT: List OpenAI models. No args\n# WHEN_TO_USE: you need to openai models\n# ARGS: see content\n# EX: [OPENAI_MODELS][/OPENAI_MODELS]\n# List OpenAI models. No args.","input_schema":null,"examples":"[\"reply with the single word OK\"]","authority_required":true,"representations":{"article":"/a/directory/OPENAI_MODELS","json":"/api/directory/OPENAI_MODELS","skill":"/api/directory/OPENAI_MODELS?format=skill","oip_contract":"/api/dispatch?key=OPENAI_MODELS"}},{"key":"PLANNER","type":"agent","method":null,"category":"agents","enabled":true,"contract":"P1: IDENTITY\nP1a: You are PLANNER. the owner messages you to dump thoughts, capture threads, iterate on lines of work that are NOT yet a concrete build (those go to BUILDER). Brain grok-4.3.\nP1b: Voice: plain, brief, literal. Never preamble. Quote IDs.\n\nP2: ROUTING MAP\nP2a: WHEN the owner starts a new thread of thought (\"I've been thinking about X\", \"for ads I want to try Y\", \"remember that Z\") → [THREAD_ADD]<short title>|<full quote>|<inferred tags>[/THREAD_ADD] (ACTION).\nP2b: WHEN the owner references an existing thread (\"for that peptide thing, also ...\") → [THREAD_LIST][/THREAD_LIST] first (READ), then [THREAD_APPEND]<id>|<line>[/THREAD_APPEND] next turn (ACTION).\nP2c: WHEN the owner asks \"what threads do I have\" / \"what am I tracking\" → [THREAD_LIST][/THREAD_LIST] (READ).\nP2d: WHEN the owner says a thread should become a real build (\"ok actually do X\") → [THREAD_GET]<id>[/THREAD_GET] (READ) THEN next turn [BUILDER_ADD]<title>|<body>|<priority>[/BUILDER_ADD] + [THREAD_CLOSE]<id>[/THREAD_CLOSE] (ACTION).\n\nP3: NEVER reply without reading or writing threads THIS turn.","input_schema":null,"examples":"[\"\"]","authority_required":true,"representations":{"article":"/a/directory/PLANNER","json":"/api/directory/PLANNER","skill":"/api/directory/PLANNER?format=skill","oip_contract":"/api/dispatch?key=PLANNER"}},{"key":"STORE_REF_IMAGE","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: Save a reference image (e.g. one sent via Blooio) to R2 and return {filename,key,url}. Arg: source_url\n# WHEN_TO_USE: you need to store ref image\n# ARGS: $1\n# EX: [STORE_REF_IMAGE]arg1[/STORE_REF_IMAGE]\n[\"$1\"]","input_schema":"{\"type\":\"object\",\"properties\":{\"arg1\":{\"type\":\"string\",\"description\":\"positional argument 1 (pipe position 1)\"}},\"required\":[\"arg1\"],\"x-arg-order\":[\"arg1\"],\"description\":\"Arguments are joined with | in the order given by x-arg-order.\"}","examples":"[\"https://miscsubjects.com/img/ref/leo-vial-black-bg.png\"]","authority_required":false,"representations":{"article":"/a/directory/STORE_REF_IMAGE","json":"/api/directory/STORE_REF_IMAGE","skill":"/api/directory/STORE_REF_IMAGE?format=skill","oip_contract":"/api/dispatch?key=STORE_REF_IMAGE"}}]},"ontology":{"conformance_group":"article","inferred_from":["field-comparison","framework","field","openai","agents","sdk"],"relationships":[],"sources":[]},"conformance":{"success_events":"/api/articles/field-openai-agents-sdk/invocations?status=success","failure_events":"/api/articles/field-openai-agents-sdk/invocations?status=failure","rule":"Repeated success and failure modes amend this object's Skill, tests, directory clarity, and article meaning under one versioned identity."},"article":{"slug":"field-openai-agents-sdk","title":"OpenAI Agents SDK","body":"# OpenAI Agents SDK — comparison record\\n\\nClaims and evidence for the common build-landscape axes live in this article graph.","hero":null,"images":[],"style":{},"tags":["field-comparison","framework"],"category":null,"model":null,"ledger":{"href":"/api/articles/field-openai-agents-sdk/ledger","live":true},"embeds":[],"widgets":[],"home":true,"claims":[],"sources":[],"reviews":[],"extra":{},"has_traversal":false,"register":"audit","status":"published","revisions":0,"contributions":[],"provenance":[],"energy":{"passes":0,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{},"head":"genesis"},"posted_at":"2026-07-22 02:00:18","created_at":"2026-07-22 02:00:18","updated_at":"2026-07-22 02:00:18","machine":{"shape":"article.machine/v1","slug":"field-openai-agents-sdk","kind":"article","read":{"human":"https://miscsubjects.com/a/field-openai-agents-sdk","json":"https://miscsubjects.com/api/articles/field-openai-agents-sdk","bundle":"https://miscsubjects.com/api/articles/field-openai-agents-sdk/bundle?format=markdown"},"traversal":{"prev":null,"next":null,"hub":null,"series":null,"position":null,"of":null},"ledger":{"claims":0,"sources":0,"contributions":0,"revisions":0,"objections_url":"https://miscsubjects.com/api/articles/field-openai-agents-sdk/objections","thread_state_url":"https://miscsubjects.com/api/protocol/thread-state?target=field-openai-agents-sdk","proof_rule":"An action is proven by its ledger receipt, never by a 200 or a description."},"standard":{"writing":"peptide standard: logical prose, zero decorative wording, every material assertion atomized as a claim with a tier and a source (or explicitly unsourced)","claim_tiers":["human","preclinical","anecdotal","mechanistic","speculative","system"],"verbatim_law":null},"terminal":{"how":"Any model may emit these commands; the owner pastes them into a terminal. $TERMINAL_KEY is read from the owner's environment — never inline the key value.","claim_append":"curl -s -X POST https://miscsubjects.com/api/protocol/claim -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"field-openai-agents-sdk\",\"text\":\"<one atomized claim>\",\"tier\":\"<human|preclinical|anecdotal|mechanistic|speculative|system>\",\"source_ids\":[],\"who_claims\":\"<model>\",\"rationale\":\"<why material>\"}'","source_append":"curl -s -X POST https://miscsubjects.com/api/protocol/sources -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"field-openai-agents-sdk\",\"sources\":[{\"type\":\"review\",\"url\":\"<url>\",\"title\":\"<title>\",\"quote\":\"<verbatim quote>\",\"summary\":\"<one line>\"}]}'","objection":"curl -s -X POST https://miscsubjects.com/api/articles/field-openai-agents-sdk/objections -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"objection\":\"<attack>\",\"surface\":\"S1-S8\",\"minimum_patch\":\"<patch>\"}'  # open intake, no key","thread_update":"curl -s -X POST https://miscsubjects.com/api/protocol/thread-update -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"target\":\"field-openai-agents-sdk\",\"raw_text\":\"<material delta>\"}'  # open intake, no key","read_back":"curl -s https://miscsubjects.com/api/articles/field-openai-agents-sdk | python3 -c 'import json,sys; d=json.load(sys.stdin); print(json.dumps(d[\"claims\"][-3:], indent=1))'"}},"representations":{"article":"/a/field-openai-agents-sdk","json":"/api/articles/field-openai-agents-sdk","markdown":"/api/articles/field-openai-agents-sdk/bundle?format=markdown","skill":"/api/articles/field-openai-agents-sdk/skill","topology":"/api/articles/field-openai-agents-sdk/topology","versions":"/api/articles/field-openai-agents-sdk/revisions","invocations":"/api/articles/field-openai-agents-sdk/invocations"},"editorial_review":null,"editorial_audit":{"slug":"field-openai-agents-sdk","ok":false,"issues":[{"code":"headline_quality","message":"headline is too short to orient a cold reader; name the subject and event: \"OpenAI Agents SDK\"","replacement":"Write a shorter literal headline naming the article subject and its central event or claim."},{"code":"hero_missing","message":"the article is published with no featured image","replacement":"Generate a hero that shows this article's own subject, inspect it, and record the inspection before this counts as finished. An article with no image is not finished."}]},"body_hash":"b06af9a470e9f28af4a16c781c4fafaa4bae0fe16600b52bd790a2ca653e1941"}}}