{"record":{"id":"c5543e50cbf0d36b","repo":"github/copilot-sdk","slug":"in-process-transport-unavailable","errorCode":null,"errorMessage":"in-process transport unavailable","messagePattern":"in-process transport unavailable","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"go/inprocess_disabled.go","lineNumber":9,"sourceCode":"//go:build !copilot_inprocess || (!darwin && !linux && !windows)\n\npackage copilot\n\nimport \"errors\"\n\nconst inProcessAvailable = false\n\nvar errInProcessUnavailable = errors.New(\"in-process transport unavailable\")\n\nfunc createInProcessHost(string, string, inProcessHostConfig) (inProcessHost, error) {\n\treturn nil, errInProcessUnavailable\n}\n","sourceCodeStart":1,"sourceCodeEnd":14,"githubUrl":"https://github.com/github/copilot-sdk/blob/cd8cf15dc3f9e762615790aaed0a771a0f392755/go/inprocess_disabled.go#L1-L14","documentation":"This build of the library has in-process support compiled out (inProcessAvailable=false), so createInProcessHost is the stub that always returns errInProcessUnavailable. Any attempt to use the in-process transport will fail immediately with this sentinel error.","triggerScenarios":"Any code path calling createInProcessHost (i.e., startInProcess) in a default build without the copilot_inprocess tag.","commonSituations":"Running tests or apps against stock builds while selecting the in-process transport; package consumers pulling the module without custom build tags.","solutions":["Rebuild with -tags copilot_inprocess on a supported platform","Use the subprocess (CLI server) transport instead","Compare errors.Is(err, copilot.errInProcessUnavailable)/message to branch to a fallback transport"],"exampleFix":"// before\nclient.Start(ctx, WithInProcess())\n// after\nif err := client.Start(ctx); err != nil && strings.Contains(err.Error(), \"in-process transport unavailable\") {\n    client = copilot.NewClient() // subprocess transport\n    err = client.Start(ctx)\n}","handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":"if err := createInProcess(); errors.Is(err, errInProcessUnavailable) {\n    return startSubprocessTransport()\n}","preventionTips":["Use the default subprocess transport unless the build includes copilot_inprocess","Document required build tags for in-process deployments","Gate in-process code paths behind a build-tag-guarded file"],"tags":["go","build-tags","platform","fallback"],"backgroundTag":"unsupported-platform","analyzedSha":"cd8cf15dc3f9e762615790aaed0a771a0f392755","analyzedAt":"2026-09-09T18:32:31.973Z","contentChangedAt":"2026-09-09T18:32:31.973Z","schemaVersion":2},"datasetVersion":"2026-09-16T04:17:20.429Z"}