Coming soon: a stream of a run’s events and a published shape for its state.
Coming soon. Not in this release. This page says what the feature is,
so that the shape is public before the code is.
Build your own view of a run against a published contract, instead of
holding the run and folding its events yourself. A run already knows
everything worth watching: which step is running, what each one decided,
what a reviewer found, what the whole thing has spent. Today a host reads
that by holding the run and folding the events itself.An observation port will make it a contract: a stream of the run’s events,
and a published shape for the state they fold into. The run’s own page
becomes one consumer of it, and a view built against the shape keeps
working when that page changes.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Obversa","description":"Public documentation for the Obversa packages","colors":{"primary":"#1C7C54","light":"#73E2A7","dark":"#1C7C54"},"logo":{"light":"https://mintcdn.com/obversa-ai/ga0E2BKT3b-S0OjJ/logo-light.svg?fit=max\u0026auto=format\u0026n=ga0E2BKT3b-S0OjJ\u0026q=85\u0026s=41009e05c6fba25474286f209b2ba288","dark":"https://mintcdn.com/obversa-ai/ga0E2BKT3b-S0OjJ/logo-dark.svg?fit=max\u0026auto=format\u0026n=ga0E2BKT3b-S0OjJ\u0026q=85\u0026s=2969e0d60816be9d098c7ad740b63063","href":"https://obversa.ai"},"favicon":"https://mintcdn.com/obversa-ai/ga0E2BKT3b-S0OjJ/favicon.svg?fit=max\u0026auto=format\u0026n=ga0E2BKT3b-S0OjJ\u0026q=85\u0026s=00371cabbeb804fed4aa2b4d0f725b6d","fonts":{"heading":{"family":"Schibsted Grotesk"},"body":{"family":"Schibsted Grotesk"}},"integrations":{"posthog":{"apiKey":"phc_B2TZ6ACgt3DgnkJ2TgLd6wfv3X3TNF3RRSjUTFNXXd47","apiHost":"https://eu.i.posthog.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"obversa-ai","hasAudioNarration":false,"actualSubdomain":"obversa-ai","customDomains":["obversa.ai"],"gitSource":{"type":"github","owner":"jonny981","repo":"obversa","deployBranch":"main","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"}},"buildId":"6aefbae232a73c26eb14edee","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Plugins","count":18},{"language":"default","tag":"Examples","count":17},{"language":"default","tag":"FAQ","count":14},{"language":"default","tag":"Patterns","count":11},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"Packages","count":8},{"language":"default","tag":"Evals and Gates","count":6},{"language":"default","tag":"Business operations","count":6},{"language":"default","tag":"Driving Runs","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iIq129k.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1isq129k.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1pUL8lJdhg.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iAq129k.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iEq129k.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1i8q1w.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwl1FgtIU.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwlRFgtIU.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwupkp-8tFQ.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwl9FgtIU.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwl5FgtIU.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3twJwlBFgg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\ncode,pre,kbd,samp,pre code{font-family:\"IBM Plex Mono\", ui-monospace, Menlo, monospace}.comparison-table{max-width:100%;isolation:isolate}.comparison-table [data-table-wrapper]{--page-padding: 0px}.comparison-table table{width:2140px;table-layout:fixed}.comparison-table th,.comparison-table td{min-width:220px;vertical-align:top}.comparison-table th:first-child,.comparison-table td:first-child{width:160px;min-width:160px;position:sticky;left:0;z-index:20;background:white}.dark .comparison-table th:first-child,.dark .comparison-table td:first-child{background:#0a0a0a}.comparison-table [data-component-part=\"scroll-area-viewport\"]:focus-visible{outline:2px solid currentColor;outline-offset:2px}"}]}
{"page":{"pagePath":"coming-soon/observation-port","slug":"/coming-soon/observation-port","pageMetadata":{"title":"An Observation Port on Every Workflow","sidebarTitle":"Observation Port","tag":"Coming soon","description":"Coming soon: a stream of a run's events and a published shape for its state.","href":"/coming-soon/observation-port"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Coming soon: a stream of a run’s events and a published shape for its state.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Coming soon.`}),` Not in this release. This page says what the feature is,\nso that the shape is public before the code is.`]})}),`\n`,_jsx(_components.p,{children:`Build your own view of a run against a published contract, instead of\nholding the run and folding its events yourself. A run already knows\neverything worth watching: which step is running, what each one decided,\nwhat a reviewer found, what the whole thing has spent. Today a host reads\nthat by holding the run and folding the events itself.`}),`\n`,_jsx(_components.p,{children:`An observation port will make it a contract: a stream of the run’s events,\nand a published shape for the state they fold into. The run’s own page\nbecomes one consumer of it, and a view built against the shape keeps\nworking when that page changes.`}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/driving/monitor`,children:`Watch a run in the browser`}),`: the page that would\nbecome one consumer of the port.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/recording/events-and-artifacts`,children:`Events and artifacts`}),`: the events the\nstream would carry.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"An Observation Port on Every Workflow","sidebarTitle":"Observation Port","tag":"Coming soon","description":"Coming soon: a stream of a run's events and a published shape for its state.","href":"/coming-soon/observation-port"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"obversa-ai","siteName":"Obversa","title":"An Observation Port on Every Workflow - Obversa","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-25T22:12:54.063Z","originalFileLocation":"coming-soon/observation-port.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Coming soon: a stream of a run\u0026#x27;s events and a published shape for its state.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Obversa\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"An Observation Port on Every Workflow - Obversa\">\u003cmeta data-mint-head property=\"og:description\" content=\"Coming soon: a stream of a run\u0026#x27;s events and a published shape for its state.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Obversa\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://obversa.ai/docs/coming-soon/observation-port\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://obversa-ai.mintlify.site/docs/_mintlify/api/og/v2?division=Driving+Runs\u0026amp;title=An+Observation+Port+on+Every+Workflow\u0026amp;description=Coming+soon%3A+a+stream+of+a+run%27s+events+and+a+published+shape+for+its+state.\u0026amp;theme=464a6e6d10d89ce00010a85b\u0026amp;signature=9abf047d242fb14bed24e10093e3c9f4a985d88423fb4fef3d910e6b00911f71\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"An Observation Port on Every Workflow - Obversa\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Coming soon: a stream of a run\u0026#x27;s events and a published shape for its state.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://obversa-ai.mintlify.site/docs/_mintlify/api/og/v2?division=Driving+Runs\u0026amp;title=An+Observation+Port+on+Every+Workflow\u0026amp;description=Coming+soon%3A+a+stream+of+a+run%27s+events+and+a+published+shape+for+its+state.\u0026amp;theme=464a6e6d10d89ce00010a85b\u0026amp;signature=9abf047d242fb14bed24e10093e3c9f4a985d88423fb4fef3d910e6b00911f71\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/obversa-ai/sMV_vwK6ktS-yieD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Obversa\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1C7C54\">\u003clink data-mint-head rel=\"canonical\" href=\"https://obversa.ai/docs/coming-soon/observation-port\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/coming-soon/observation-port.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://obversa.ai/#organization\",\"name\":\"Obversa\",\"url\":\"https://obversa.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/obversa-ai/ga0E2BKT3b-S0OjJ/logo-light.svg?fit=max\u0026auto=format\u0026n=ga0E2BKT3b-S0OjJ\u0026q=85\u0026s=41009e05c6fba25474286f209b2ba288\"}},{\"@type\":\"WebSite\",\"@id\":\"https://obversa.ai/docs#website\",\"name\":\"Obversa\",\"url\":\"https://obversa.ai/docs\",\"publisher\":{\"@id\":\"https://obversa.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://obversa.ai/docs/coming-soon/observation-port#webpage\",\"url\":\"https://obversa.ai/docs/coming-soon/observation-port\",\"name\":\"An Observation Port on Every Workflow\",\"description\":\"Coming soon: a stream of a run's events and a published shape for its state.\",\"dateModified\":\"2026-09-25T22:12:54.063Z\",\"isPartOf\":{\"@id\":\"https://obversa.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://obversa.ai/docs/coming-soon/observation-port#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://obversa.ai/docs/coming-soon/observation-port#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Driving Runs\",\"item\":\"https://obversa.ai/docs/driving/runner\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"An Observation Port on Every Workflow\",\"item\":\"https://obversa.ai/docs/coming-soon/observation-port\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://obversa.ai/docs/coming-soon/observation-port#article\",\"headline\":\"An Observation Port on Every Workflow\",\"name\":\"An Observation Port on Every Workflow\",\"description\":\"Coming soon: a stream of a run's events and a published shape for its state.\",\"url\":\"https://obversa.ai/docs/coming-soon/observation-port\",\"mainEntityOfPage\":{\"@id\":\"https://obversa.ai/docs/coming-soon/observation-port#webpage\"},\"dateModified\":\"2026-09-25T22:12:54.063Z\",\"publisher\":{\"@id\":\"https://obversa.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://obversa.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Obversa\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Obversa\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/coming-soon/observation-port.md","siteName":"Obversa","nav":{"global":null,"groups":[{"group":"Start","pages":[{"title":"Documentation","href":"/index"},{"title":"Installation","href":"/get-started/installation"},{"title":"First Run","href":"/get-started/first-run"}]},{"group":"Concepts","pages":[{"title":"Workflows","href":"/concepts/workflows"},{"title":"Feedback Loops","href":"/concepts/feedback-loops"},{"title":"The Record","href":"/concepts/record"},{"title":"Running","href":"/concepts/running"},{"title":"Where a Workflow Lives","sidebarTitle":"Where it lives","href":"/concepts/where-a-workflow-lives"},{"title":"Surfaces","href":"/concepts/surfaces"},{"title":"Memory","href":"/concepts/memory"},{"title":"Workspace","href":"/concepts/workspace"}]},{"group":"Patterns","pages":[{"title":"Patterns","href":"/patterns/index"},{"title":"Get a Second Opinion","sidebarTitle":"Second Opinion","href":"/patterns/writer-and-reviewer"},{"title":"Check the Brief Was Met","href":"/patterns/check-the-brief"},{"title":"Ask a Panel","href":"/patterns/review-panel"},{"title":"Know When to Stop","href":"/patterns/judge-stops-the-loop"},{"title":"Compare Different Approaches","href":"/patterns/tournament"},{"title":"Automate the Routine Work","href":"/patterns/command-kickback"},{"title":"Ask a Person","href":"/patterns/approval"},{"title":"Workflows That Improve Themselves","href":"/patterns/workflows-that-improve-themselves"},{"title":"Check Before Acting","href":"/patterns/safe-change"},{"title":"Bring the Team Together","sidebarTitle":"Team Discussion","href":"/patterns/team-conversation"}]},{"group":"Examples","pages":[{"title":"Examples","href":"/workflows/index"},{"group":"Product development","pages":[{"title":"Feature Delivery","href":"/workflows/feature-team"},{"title":"Shipping a Reviewed Change Through GitHub","sidebarTitle":"Shipping Through GitHub","href":"/workflows/forge-helper"},{"title":"Backlog Grooming, Then a Person Ranks","sidebarTitle":"Backlog Grooming","href":"/workflows/backlog-groom-then-rank"},{"title":"A Shape Up Cycle","sidebarTitle":"Shape Up Cycle","href":"/workflows/product/shape-up-cycle"}]},{"group":"Finance","pages":[{"title":"Market Observations, Then a Person Considers","sidebarTitle":"Market Session Advice","href":"/workflows/markets/market-session-advice"},{"title":"Invoice Chasing, a Person on Disputes","sidebarTitle":"Invoice Chase","href":"/workflows/finance/invoice-chase"}]},{"group":"Business operations","pages":[{"title":"Contract Review Against a Playbook","sidebarTitle":"Contract Review","href":"/workflows/contract-playbook"},{"title":"Outreach Drafted by a Model, Sent by a Person","sidebarTitle":"Draft, Then Send","href":"/workflows/sales/draft-then-send"},{"title":"Support Triage, a Person on the Rest","sidebarTitle":"Triage With Escalation","href":"/workflows/support/triage-with-escalation"},{"title":"A Shortlist With Verifiable Gates","sidebarTitle":"Shortlist","href":"/workflows/hiring/shortlist"},{"title":"Approve the Exact Payload, Not a Story","sidebarTitle":"Approve the Payload","href":"/workflows/ops/approve-the-exact-payload"},{"title":"A Stopped Run Carries On","sidebarTitle":"Resume the Run","href":"/workflows/ops/handoff-that-resumes"}]},{"group":"Research and knowledge","pages":[{"title":"Literature Watch, a Person Curates","sidebarTitle":"Literature Watch","href":"/workflows/research/literature-watch"},{"title":"A Notes Vault the Person Steers","sidebarTitle":"Vault Curator","href":"/workflows/knowledge/vault-curator"}]},{"group":"Writing and content","pages":[{"title":"A Writer, a Strict Grader, a Judge, an Editor","sidebarTitle":"Writer, Grader, Judge","href":"/workflows/editorial/writer-grader-cap"},{"title":"Translate, Reflect, Glossary, Then You","sidebarTitle":"Translate and Reflect","href":"/workflows/translate-reflect"}]}]},{"group":"Evals and Gates","pages":[{"title":"Evals in an Agent Workflow","sidebarTitle":"Evals","href":"/reviewing/evals"},{"title":"Workflows that Improve Themselves","sidebarTitle":"Self-improving workflows","href":"/reviewing/workflows-that-improve-themselves"},{"title":"Callback Gates","href":"/reviewing/callback-gates"},{"title":"Review Loop","href":"/reviewing/review-loop"},{"title":"Decisions Bound to Bytes","href":"/reviewing/proof-acceptance"},{"title":"A Gate That Shows You the Real Thing","sidebarTitle":"Preview Gate","tag":"Coming soon","href":"/coming-soon/preview-gate"}]},{"group":"Recording Runs","pages":[{"title":"Read a Record","href":"/recording/read-a-record"},{"title":"Events and Artifacts","href":"/recording/events-and-artifacts"},{"title":"Safe Node Attempts","href":"/recording/node-attempts"}]},{"group":"Driving Runs","pages":[{"title":"Supervised Local Runs","href":"/driving/runner"},{"title":"Run One Step on Another Machine","sidebarTitle":"Remote Nodes","tag":"Coming soon","href":"/driving/remote-nodes"},{"title":"Fast and Deliberate, Side by Side","sidebarTitle":"Fast and Deliberate","tag":"Coming soon","href":"/coming-soon/fast-and-deliberate"},{"title":"Supervision While a Step Runs","sidebarTitle":"Supervision","tag":"Coming soon","description":"Coming soon: The attempt's own events feed a fast decision model on a debounce, and the run carries on, stops and retries, or puts the step to a person.","href":"/coming-soon/supervision"},{"title":"An Observation Port on Every Workflow","sidebarTitle":"Observation Port","tag":"Coming soon","href":"/coming-soon/observation-port"}]},{"group":"Surfaces and Hosts","pages":[{"title":"Watch a Run in the Browser","sidebarTitle":"Watch in the Browser","description":"A run serves its own page on a local port: each step's state, the findings, the questions waiting, and the tail of the record.","href":"/driving/monitor"},{"title":"Obversa in cmux","href":"/hosts/cmux"},{"title":"Review a Diff","sidebarTitle":"Review a Diff","href":"/hosts/review"}]},{"group":"Writing Workflow Shapes","pages":[{"title":"Your Own Workflow Shape","href":"/graphs/contract"},{"title":"Built-in Pipeline","href":"/graphs/pipeline"},{"title":"Plan Admission","href":"/graphs/plan-admission"},{"title":"Graph Executor","href":"/graphs/executor"}]},{"group":"Memory","pages":[{"title":"Memory Port","href":"/memory/index"},{"title":"Memory Adapters","href":"/memory/adapters"},{"title":"Memory Mechanics","href":"/memory/mechanics"}]},{"group":"Workspace","pages":[{"title":"Workspace Contract","href":"/workspace/contract"},{"title":"Workspace Example","href":"/workspace/example"}]},{"group":"Compare","pages":[{"title":"Compare agent workflows","sidebarTitle":"Comparison","href":"/compare/index"}]},{"group":"FAQ","pages":[{"title":"What Is a Domain-Specific Harness?","sidebarTitle":"Domain-Specific Harness","href":"/glossary/domain-specific-harness"},{"title":"What Is a Software Factory?","sidebarTitle":"Software Factory","href":"/glossary/software-factory"},{"title":"What Is an Agent Harness?","sidebarTitle":"Agent Harness","href":"/glossary/agent-harness"},{"title":"What Is a Meta-Harness?","sidebarTitle":"Meta-Harness","href":"/glossary/meta-harness"},{"title":"What Is an Agent Pipeline With a Review and a Person?","sidebarTitle":"Agent Pipeline","href":"/glossary/agent-pipeline"},{"title":"What Happens When an Agent Crashes Halfway?","sidebarTitle":"Crash Recovery","href":"/glossary/crash-recovery"},{"title":"Do I Need Temporal to Survive a Crash?","sidebarTitle":"Durable Execution","href":"/glossary/durable-execution"},{"title":"Should Another Model Review the Code?","sidebarTitle":"Cross-Model Review","href":"/glossary/cross-model-review"},{"title":"How Many Reviewers Have to Accept?","sidebarTitle":"Review Panel","href":"/glossary/review-panel"},{"title":"Where Does a Person Approve the Change?","sidebarTitle":"Human Approval","href":"/glossary/human-approval"},{"title":"Can an LLM Judge Replace a Person?","sidebarTitle":"LLM as Judge","href":"/glossary/llm-as-judge"},{"title":"When Should an Agent Eval Loop Stop?","sidebarTitle":"Review Loop","href":"/glossary/review-loop"},{"title":"Should Team Rules Live in AGENTS.md?","sidebarTitle":"Workflow File","href":"/glossary/workflow-file"},{"title":"How Do Two Agents Share One File?","sidebarTitle":"Shared Files","href":"/glossary/shared-files"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/packages/index"},{"group":"Packages","pages":[{"title":"Obversa","href":"/packages/obversa"},{"title":"Runtime","href":"/packages/runtime"},{"title":"Runner","href":"/packages/runner"},{"title":"API","href":"/packages/api"},{"title":"Core","href":"/packages/core"},{"title":"Built-in Workflows","href":"/packages/builtin-workflows"},{"title":"Surface","href":"/packages/surface"},{"title":"Surface Diff","href":"/packages/surface-diff"}]},{"group":"Plugins","pages":[{"title":"Engine Options","href":"/packages/engines"},{"title":"Claude CLI Engine","href":"/packages/engine-claude-cli"},{"title":"Codex CLI Engine","href":"/packages/engine-codex-cli"},{"title":"Devin CLI Engine","href":"/packages/engine-devin-cli"},{"title":"Grok CLI Engine","href":"/packages/engine-grok-cli"},{"title":"OpenCode CLI Engine","href":"/packages/engine-opencode-cli"},{"title":"Claude Agent SDK Engine","href":"/packages/engine-claude-agent-sdk"},{"title":"Anthropic API Engine","href":"/packages/engine-anthropic-api"},{"title":"Jev API Engine","href":"/packages/engine-jev-api"},{"title":"OpenAI Decisions Engine","href":"/packages/engine-openai-decisions"},{"title":"Mastra Engine","href":"/packages/engine-mastra"},{"title":"OpenAI Agents Engine","href":"/packages/engine-openai-agents"},{"title":"eve Engine","tag":"Coming soon","href":"/packages/engine-eve"},{"title":"LangGraph Engine","tag":"Coming soon","href":"/packages/engine-langgraph"},{"title":"Git Memory","href":"/packages/memory-git"},{"title":"Simple Memory","href":"/packages/memory-simple"},{"title":"Markdown Memory","href":"/packages/memory-markdown"},{"title":"Webhook Notifications","href":"/packages/notify-webhook"}]}]}]},"basePath":"","title":"An Observation Port on Every Workflow - Obversa","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}