@doxbrix/doxloop 0.1.4 → 0.2.0

package/assets/doxbrix-preview.css

@@ -3137,7 +3137,8 @@ body.dxb-tryit-open {
   --dp-primary-shadow-07: rgb(var(--dp-primary-rgb) / 0.07);
   --dp-primary-shadow-10: rgb(var(--dp-primary-rgb) / 0.10);
   --dp-page-text: #141428;
-  --dp-muted-text: #737891;
+  --dp-muted-text: #60677d;
+  --dp-body-text: #4b5563;
   --dp-line: #e5e7f0;
   --dp-surface-soft: #f8f7ff;
   background-color: var(--dxb-background-light, #fff);
@@ -3147,6 +3148,8 @@ body.dxb-tryit-open {
   color: var(--dp-page-text);
   font-size: 0.9375rem;
   line-height: 1.62;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
 }
 
 .dp-root--published,
@@ -3242,7 +3245,7 @@ body.dxb-tryit-open {
   border: 1px solid #dfe3ee;
   border-radius: 8px;
   background: #fff;
-  color: #7b8197;
+  color: #596174;
   box-shadow: 0 1px 4px rgba(20, 20, 40, 0.04);
 }
 
@@ -3255,7 +3258,7 @@ body.dxb-tryit-open {
   padding: 0 8px;
   border-radius: 6px;
   background: #f7f8fc;
-  color: #6f7488;
+  color: #52596c;
   border-color: #dfe3ee;
   font-size: 0.75rem;
 }
@@ -5498,6 +5501,7 @@ body.dxb-tryit-open {
   color-scheme: dark;
   --dp-page-text: #eef1f7;
   --dp-muted-text: #9ba3b2;
+  --dp-body-text: #c6ccd7;
   --dp-line: #2c313b;
   --dp-surface-soft: #1b1f27;
   --text-primary: #eef1f7;
@@ -6235,6 +6239,7 @@ body.dxb-preview-mobile > .dp-root--published {
 .dp-root--published[data-shell-theme='atlas'][data-color-theme='dark'] {
   --dp-page-text: #f4eff1;
   --dp-muted-text: #aaa4a7;
+  --dp-body-text: #d4cfd1;
   --dp-line: #262123;
   --dp-surface-soft: #181415;
   --dp-primary: var(--dxb-primary-light, var(--project-primary));
@@ -6314,9 +6319,10 @@ body.dxb-preview-mobile > .dp-root--published {
 .dxb-atlas-search-cluster .dp-topnav-search kbd {
   border: 0;
   background: transparent;
-  color: #837d80;
+  color: #141428;
   padding: 0;
 }
+.dp-root--published[data-shell-theme='atlas'][data-color-theme='dark'] .dxb-atlas-search-cluster .dp-topnav-search kbd { color: #d4cfd1; }
 
 .dxb-atlas-assistant,
 .dxb-atlas-header-link,
@@ -6647,7 +6653,15 @@ body.dxb-search-open { overflow: hidden; }
   color: var(--dp-muted-text);
   font-size: 14px;
 }
+.dp-root--published[data-shell-theme='atlas'] .dp-nav-item:hover {
+  width: calc(100% + 12px);
+  margin-left: -12px;
+  padding-left: 12px;
+}
 .dp-root--published[data-shell-theme='atlas'] .dp-nav-item.active {
+  width: calc(100% + 12px);
+  margin-left: -12px;
+  padding-left: 12px;
   background: rgb(var(--dp-primary-rgb) / .12);
   color: var(--project-primary);
   font-weight: 600;
@@ -6681,19 +6695,20 @@ body.dxb-search-open { overflow: hidden; }
   gap: 24px;
 }
 .dxb-atlas-title-copy { min-width: 0; }
-.dxb-atlas-eyebrow { margin-bottom: 8px; color: var(--project-primary); font-size: 14px; font-weight: 600; }
+.dxb-atlas-eyebrow { margin-bottom: 8px; color: var(--dp-page-text); font-size: 14px; font-weight: 600; }
+.dp-root--published[data-shell-theme='atlas'] .dp-nav-item.active .dp-nav-item-label { color: var(--dp-page-text); font-weight: 600; }
 .dp-root--published[data-shell-theme='atlas'] .dp-page-title {
   color: var(--dp-page-text);
-  font-size: 40px;
-  line-height: 1.14;
-  letter-spacing: -0.03em;
-  font-weight: 700;
+  font-size: 36px;
+  line-height: 1.2;
+  letter-spacing: -0.025em;
+  font-weight: 600;
 }
 .dxb-atlas-description {
   margin: 8px 0 0;
-  color: var(--dp-muted-text);
-  font-size: 20px;
-  line-height: 1.45;
+  color: var(--dp-body-text);
+  font-size: 18px;
+  line-height: 1.55;
 }
 .dxb-atlas-copy-page {
   display: inline-flex;
@@ -6710,9 +6725,9 @@ body.dxb-search-open { overflow: hidden; }
   font-size: 14px;
   white-space: nowrap;
 }
-.dp-root--published[data-shell-theme='atlas'] .dp-blocks { margin-top: 32px; color: var(--dp-muted-text); }
-.dp-root--published[data-shell-theme='atlas'] :where(.dp-p, .dp-wysiwyg-content) { color: var(--dp-muted-text); font-size: 16px; line-height: 1.72; }
-.dp-root--published[data-shell-theme='atlas'] :where(.dp-h2, .dp-wysiwyg-content h2) { color: var(--dp-page-text); font-size: 26px; line-height: 1.3; margin-top: 42px; }
+.dp-root--published[data-shell-theme='atlas'] .dp-blocks { margin-top: 32px; color: var(--dp-body-text); }
+.dp-root--published[data-shell-theme='atlas'] :where(.dp-p, .dp-wysiwyg-content) { color: var(--dp-body-text); font-size: 16px; line-height: 1.75; letter-spacing: -0.0125rem; }
+.dp-root--published[data-shell-theme='atlas'] :where(.dp-h2, .dp-wysiwyg-content h2) { color: var(--dp-page-text); font-size: 24px; line-height: 1.33; margin-top: 42px; }
 .dp-root--published[data-shell-theme='atlas'] :where(.dp-h3, .dp-wysiwyg-content h3) { color: var(--dp-page-text); font-size: 20px; }
 .dp-root--published[data-shell-theme='atlas'] .df-inline-code {
   border-color: var(--dp-line);
@@ -6732,6 +6747,37 @@ body.dxb-search-open { overflow: hidden; }
 .dp-root--published[data-shell-theme='atlas'] .dp-toc-entry { color: var(--dp-muted-text); font-size: 14px; line-height: 1.45; padding-top: 5px; padding-bottom: 5px; }
 .dp-root--published[data-shell-theme='atlas'] .dp-toc-entry.active { color: var(--project-primary); }
 
+/* Focused page rendering used inside the Doxloop Pages workspace. The outer
+   workspace already owns navigation and actions, so repeating the reader
+   shell inside its iframe only reduces the space available to review content. */
+.dp-root--published.dp-root--embedded .dxb-atlas-header,
+.dp-root--published.dp-root--embedded .dp-leftnav,
+.dp-root--published.dp-root--embedded .dp-toc,
+.dp-root--published.dp-root--embedded .dxb-atlas-copy-page,
+.dp-root--published.dp-root--embedded .dxb-preview-search {
+  display: none !important;
+}
+
+.dp-root--published.dp-root--embedded[data-shell-theme='atlas'] .dp-body {
+  width: 100%;
+  min-height: 100vh;
+  display: block;
+  margin: 0;
+  padding: 0;
+}
+
+.dp-root--published.dp-root--embedded[data-shell-theme='atlas'] .dp-main {
+  width: 100%;
+  margin: 0;
+}
+
+.dp-root--published.dp-root--embedded[data-shell-theme='atlas'] .dp-content-wrap {
+  width: min(100%, 920px);
+  max-width: none;
+  margin: 0 auto;
+  padding: 32px clamp(24px, 5vw, 56px) 64px;
+}
+
 @media (max-width: 1180px) {
   .dxb-atlas-header-inner { grid-template-columns: 210px minmax(280px, 1fr) auto; }
   .dxb-atlas-header-link span { display: none; }
@@ -6868,3 +6914,19 @@ body.dxb-search-open { overflow: hidden; }
   color: var(--dp-page-text);
   font-weight: 600;
 }
+
+/* Editing is controlled by the parent workspace in embedded previews. */
+.dp-root--embedded .dp-edit-page { display: none; }
+/* Doc-version selector follows the DocsAI CLI reader's sidebar layout. */
+[data-doc-version][hidden] { display: none !important; }
+.dp-version-switcher { margin: 16px 12px 0; flex-shrink: 0; }
+.dp-version-trigger { list-style: none; display: flex; align-items: center; gap: 8px; min-height: 36px; padding: 0 10px; border: 1px solid color-mix(in srgb, currentColor 20%, transparent); border-radius: 8px; color: inherit; background: color-mix(in srgb, currentColor 4%, transparent); font-size: 13px; font-weight: 600; cursor: pointer; }
+.dp-version-trigger::-webkit-details-marker { display: none; }
+.dp-version-trigger:hover, .dp-version-trigger:focus-visible { border-color: var(--project-primary, #6366f1); }
+.dp-version-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dp-version-tag { padding: 1px 7px; border-radius: 999px; background: color-mix(in srgb, var(--project-primary, #6366f1) 14%, transparent); color: var(--project-primary, #6366f1); font-size: 11px; font-weight: 600; }
+.dp-version-menu { margin-top: 4px; padding: 4px; border: 1px solid color-mix(in srgb, currentColor 20%, transparent); border-radius: 8px; }
+.dp-version-option { display: flex; align-items: center; gap: 8px; padding: 7px 9px; border-radius: 6px; color: inherit; font-size: 13px; text-decoration: none; }
+.dp-version-option:hover { background: color-mix(in srgb, currentColor 8%, transparent); }
+.dp-version-option.active { color: var(--project-primary, #6366f1); font-weight: 600; }
+.dp-version-option[aria-disabled] { opacity: .5; }

package/contracts/agent-events-v1.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://doxloop.dev/contracts/agent-events-v1.schema.json","title":"Doxloop agent workflow event v1","type":"object","required":["schemaVersion","type","at"],"properties":{"schemaVersion":{"const":1},"type":{"enum":["stage","outcome"]},"at":{"type":"string","format":"date-time"}},"oneOf":[{"description":"A workflow stage changed state.","required":["id","label","status"],"properties":{"schemaVersion":{"const":1},"type":{"const":"stage"},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"status":{"enum":["pending","running","completed","failed"]},"progress":{"type":"object","required":["done"],"properties":{"done":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0}},"additionalProperties":false},"at":{"type":"string","format":"date-time"}},"additionalProperties":false},{"description":"What the job concluded, announced once it settles.","required":["kind","status","message"],"properties":{"schemaVersion":{"const":1},"type":{"const":"outcome"},"kind":{"const":"sync"},"status":{"enum":["current","stale","proposal","skipped","failed","unknown"]},"message":{"type":"string","minLength":1},"pages":{"type":"integer","minimum":0},"proposalId":{"type":"string","minLength":1},"at":{"type":"string","format":"date-time"}},"additionalProperties":false}]}

package/contracts/coverage-v1.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://doxloop.dev/contracts/coverage-v1.schema.json",
+  "title": "Doxloop source intelligence v1",
+  "type": "object",
+  "required": ["generatedAt", "health", "coverage", "evidenceDiagnostics"],
+  "properties": {
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "health": { "type": "array", "items": { "type": "object" } },
+    "coverage": {
+      "type": "object",
+      "required": ["metrics", "groups", "pages", "disclaimer"],
+      "properties": {
+        "metrics": { "type": "array", "items": { "$ref": "#/$defs/coverageItem" } },
+        "groups": { "type": "array", "items": { "$ref": "#/$defs/group" } },
+        "pages": { "type": "array", "items": { "type": "string" } },
+        "disclaimer": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "evidenceDiagnostics": { "type": "array", "items": { "type": "object" } }
+  },
+  "$defs": {
+    "coverageItem": {
+      "type": "object",
+      "required": ["id", "label", "documented", "total", "excluded", "percent", "status", "denominator", "items"],
+      "properties": {
+        "id": { "type": "string" }, "label": { "type": "string" },
+        "documented": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 },
+        "excluded": { "type": "integer", "minimum": 0 }, "percent": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "status": { "enum": ["measured", "unknown"] }, "denominator": { "type": "string" },
+        "items": { "type": "array", "items": { "$ref": "#/$defs/item" } }
+      },
+      "additionalProperties": false
+    },
+    "item": {
+      "type": "object",
+      "required": ["id", "surface", "label", "state"],
+      "properties": {
+        "id": { "type": "string" }, "surface": { "type": "string" }, "label": { "type": "string" },
+        "state": { "enum": ["documented", "uncovered", "excluded", "needs-human", "planned", "stale"] },
+        "source": { "type": "string" }, "path": { "type": "string" }, "kind": { "type": "string" },
+        "page": { "type": "string" }, "suggestedPage": { "type": "string" }, "reason": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "group": {
+      "type": "object",
+      "required": ["source", "documented", "total", "percent", "status"],
+      "properties": {
+        "source": { "type": "string" }, "scope": { "type": "object" },
+        "documented": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 },
+        "percent": { "type": "integer", "minimum": 0, "maximum": 100 }, "status": { "enum": ["measured", "unknown"] }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/drift-v1.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://doxloop.dev/contracts/drift-v1.schema.json","title":"Doxloop drift result v1","type":"object","required":["status","pages","trackedPages","notes"],"properties":{"status":{"enum":["current","stale","unknown"]},"pages":{"type":"array"},"trackedPages":{"type":"integer","minimum":0},"notes":{"type":"array","items":{"type":"string"}}}}

package/contracts/evaluation-v1.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://doxloop.dev/contracts/evaluation-v1.schema.json",
+  "title": "Doxloop evaluation report v1",
+  "type": "object",
+  "required": ["schemaVersion", "contractVersion", "generatedAt", "mode", "project", "score", "metrics", "reviewer"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "contractVersion": { "const": "1.0.0" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "mode": { "enum": ["generation", "update"] },
+    "project": { "type": "string", "minLength": 1 },
+    "score": { "type": "number", "minimum": 0, "maximum": 100 },
+    "metrics": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "score", "weight", "detail"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "score": { "type": "number", "minimum": 0, "maximum": 100 },
+          "weight": { "type": "number", "exclusiveMinimum": 0 },
+          "detail": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "durationMs": { "type": "number", "minimum": 0 },
+    "usage": {
+      "type": "object",
+      "properties": {
+        "inputTokens": { "type": "number", "minimum": 0 },
+        "outputTokens": { "type": "number", "minimum": 0 },
+        "costUsd": { "type": "number", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "reviewer": {
+      "type": "object",
+      "required": ["accepted", "revised", "rejected"],
+      "properties": {
+        "accepted": { "type": "integer", "minimum": 0 },
+        "revised": { "type": "integer", "minimum": 0 },
+        "rejected": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "regression": {
+      "type": "object",
+      "required": ["baselineScore", "delta", "threshold", "blocked"],
+      "properties": {
+        "baselineScore": { "type": "number", "minimum": 0, "maximum": 100 },
+        "delta": { "type": "number" },
+        "threshold": { "type": "number", "minimum": 0 },
+        "blocked": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/quality-codes-v1.json

@@ -0,0 +1 @@
+{"contractVersion":"1.0.0","compatibility":"Codes are append-only within v1. Existing codes will not be renamed or removed without a major contract version.","prefixes":{"validation.":"Existing deterministic validation issue code.","quality.build.":"Generator strict build.","quality.link.":"External link status.","quality.example.":"Executable or source-verified example.","quality.schema.":"Connector-native schema lint.","quality.accessibility.":"Rendered accessibility automation or manual review.","quality.visual.":"Visual baseline status.","quality.lint.":"Documentation linting.","quality.claim.":"Claim-level evidence state.","quality.ratchet.":"Quality baseline and ratcheting state."}}

package/contracts/quality-report-v1.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://doxloop.dev/contracts/quality-report-v1.schema.json","title":"Doxloop quality report v1","type":"object","required":["schemaVersion","contractVersion","generatedAt","inputHash","project","generator","status","checks","counts","artifacts","options"],"properties":{"schemaVersion":{"const":1},"contractVersion":{"const":"1.0.0"},"generatedAt":{"type":"string","format":"date-time"},"inputHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"project":{"type":"string"},"generator":{"type":"string"},"status":{"enum":["pass","warning","fail"]},"checks":{"type":"array","items":{"type":"object","required":["code","category","status","message"],"properties":{"code":{"type":"string"},"category":{"enum":["validation","build","links","examples","schemas","accessibility","visual","lint","claims"]},"status":{"enum":["pass","warning","fail","skipped"]},"message":{"type":"string"},"file":{"type":"string"},"detail":{"type":"string"},"fixable":{"type":"boolean"}}}},"counts":{"type":"object","required":["passed","warnings","failed","skipped"],"properties":{"passed":{"type":"integer","minimum":0},"warnings":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"skipped":{"type":"integer","minimum":0}}},"artifacts":{"type":"object"},"options":{"type":"object"}},"additionalProperties":false}

package/contracts/validation-v1.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://doxloop.dev/contracts/validation-v1.schema.json","title":"Doxloop validation result v1","type":"object","required":["issues","pages","errors","warnings"],"properties":{"issues":{"type":"array","items":{"type":"object","required":["severity","code","message"],"properties":{"severity":{"enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"file":{"type":"string"}}}},"pages":{"type":"array","items":{"type":"string"}},"errors":{"type":"integer","minimum":0},"warnings":{"type":"integer","minimum":0}}}

package/dist/agent-failure.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Why an agent session ended, in words a reader can act on. A bare "exited
+ * with status 1" hid a signed-out Claude Code for a whole planning run: the
+ * agent's own error text names the cause, and a sign-in or account problem
+ * needs a different next step than a retry.
+ */
+import { DoxloopError } from './errors.js';
+import type { AgentName } from './types.js';
+export type AgentFailureKind = 'sign-in' | 'account' | 'other';
+export declare function agentDisplayName(agent: AgentName): string;
+/** Sign-in trouble: expired OAuth, a missing login, a rejected key. */
+export declare function isAgentSignInFailure(text: string | undefined): boolean;
+/** Account trouble: out of credits, quota, or rate/usage limits. */
+export declare function isAgentAccountFailure(text: string | undefined): boolean;
+export declare function agentFailureKind(text: string | undefined): AgentFailureKind;
+/**
+ * The most useful error text a session left: the formatter's stop reason
+ * (the agent's own result event) or else the last error-looking line on
+ * stderr. Prefixes such as "stopped with an error:" are removed.
+ */
+export declare function agentFailureDetail(stopReason: string | undefined, stderr?: string): string | undefined;
+/** One sentence that names the cause and the next step. */
+export declare function describeAgentFailure(agent: AgentName, detail: string): {
+    kind: AgentFailureKind;
+    message: string;
+};
+/** A session failure that carries its cause, so callers can tell sign-in trouble from task failures. */
+export declare class AgentSessionError extends DoxloopError {
+    readonly kind: AgentFailureKind;
+    readonly detail: string;
+    readonly agent: AgentName;
+    constructor(agent: AgentName, label: string, exitCode: number, detail: string);
+}
+/** The refusal shown before a run starts with a signed-out assistant. */
+export declare function agentSignedOutMessage(agent: AgentName): string;
+//# sourceMappingURL=agent-failure.d.ts.map

package/dist/agent-failure.js

@@ -0,0 +1,98 @@
+/**
+ * Why an agent session ended, in words a reader can act on. A bare "exited
+ * with status 1" hid a signed-out Claude Code for a whole planning run: the
+ * agent's own error text names the cause, and a sign-in or account problem
+ * needs a different next step than a retry.
+ */
+import { DoxloopError } from './errors.js';
+const DISPLAY_NAMES = { claude: 'Claude Code', codex: 'Codex', gemini: 'Gemini' };
+const SIGN_IN_COMMANDS = {
+    claude: 'Run `claude auth login`',
+    codex: 'Run `codex login`',
+    gemini: 'Run `gemini` once in a terminal and sign in (or set GEMINI_API_KEY)',
+};
+export function agentDisplayName(agent) {
+    return DISPLAY_NAMES[agent];
+}
+/** Sign-in trouble: expired OAuth, a missing login, a rejected key. */
+export function isAgentSignInFailure(text) {
+    return /failed to authenticate|authenticat(?:e|ion) (?:failed|error|required)|oauth|not (?:logged|signed) in|log ?in required|please (?:log|sign) ?in|\/login\b|auth login|\b401\b|unauthori[sz]ed|invalid (?:api[ _-]?key|x-api-key|token|credentials)|api key (?:is )?(?:missing|invalid|not (?:set|found))|token (?:has )?expired|refresh token/i.test(text ?? '');
+}
+/** Account trouble: out of credits, quota, or rate/usage limits. */
+export function isAgentAccountFailure(text) {
+    return /credit balance|insufficient[_ ](?:quota|credits?|funds)|out of credits|quota|usage limit|hit your (?:session|usage|weekly|daily) limit|rate[ _-]?limit|too many requests|\b429\b|billing/i.test(text ?? '');
+}
+export function agentFailureKind(text) {
+    if (isAgentSignInFailure(text))
+        return 'sign-in';
+    if (isAgentAccountFailure(text))
+        return 'account';
+    return 'other';
+}
+const ANSI = /\u001b\[[0-9;?]*[ -/]*[@-~]|\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)/g;
+/**
+ * The most useful error text a session left: the formatter's stop reason
+ * (the agent's own result event) or else the last error-looking line on
+ * stderr. Prefixes such as "stopped with an error:" are removed.
+ */
+export function agentFailureDetail(stopReason, stderr = '') {
+    const fromStop = stopReason?.replace(/^stopped with an error:\s*/i, '').replace(/^stopped because its API request failed:\s*/i, '').trim();
+    if (fromStop)
+        return fromStop;
+    const lines = stderr.replace(ANSI, '').split(/\r?\n/).map((line) => line.trim()).filter(Boolean)
+        .filter((line) => !/^Reading additional input from stdin/i.test(line));
+    const errorLine = [...lines].reverse().find((line) => /error|fail|denied|unauthori|expired|not (?:logged|signed) in|quota|limit/i.test(line));
+    const picked = errorLine ?? lines.at(-1);
+    return picked ? compact(picked.replace(/^\S*\d{4}-\d{2}-\d{2}T\S+\s+(?:ERROR|WARN|INFO)\s+/, '')) : undefined;
+}
+/** The cause without the agent's own "Failed to authenticate:" wrapper. */
+function signInCause(detail) {
+    return detail.replace(/^(?:API Error:\s*)?(?:Failed to authenticate|Authentication (?:failed|error))[:.]?\s*/i, '').replace(/\.$/, '') || detail;
+}
+/** One sentence that names the cause and the next step. */
+export function describeAgentFailure(agent, detail) {
+    const name = agentDisplayName(agent);
+    const kind = agentFailureKind(detail);
+    if (kind === 'sign-in') {
+        return {
+            kind,
+            message: `${name} could not sign in (${compact(signInCause(detail))}). ${SIGN_IN_COMMANDS[agent]} or switch assistant, then retry.`,
+        };
+    }
+    if (kind === 'account') {
+        return {
+            kind,
+            message: `${name} stopped on an account limit (${compact(detail.replace(/\.$/, ''))}). Wait for the limit to reset or add credits, or switch assistant, then retry.`,
+        };
+    }
+    return { kind, message: compact(detail) };
+}
+/** A session failure that carries its cause, so callers can tell sign-in trouble from task failures. */
+export class AgentSessionError extends DoxloopError {
+    kind;
+    detail;
+    agent;
+    constructor(agent, label, exitCode, detail) {
+        const described = describeAgentFailure(agent, detail);
+        super(described.kind === 'other'
+            ? `${agent} ${label} exited with status ${exitCode}: ${described.message}`
+            : described.message);
+        this.name = 'AgentSessionError';
+        this.kind = described.kind;
+        this.detail = detail;
+        this.agent = agent;
+    }
+}
+function compact(value, maximum = 240) {
+    const single = value.replace(/\s+/g, ' ').trim();
+    return single.length > maximum ? `${single.slice(0, maximum - 1)}…` : single;
+}
+/** The refusal shown before a run starts with a signed-out assistant. */
+export function agentSignedOutMessage(agent) {
+    if (agent === 'claude')
+        return 'Claude Code is signed out. Open Terminal, run `claude auth login`, then try again — or switch to another assistant.';
+    if (agent === 'codex')
+        return 'Codex is signed out. Open Terminal, run `codex login`, then try again — or switch to another assistant.';
+    return 'Gemini is not signed in. Open Terminal, run `gemini` and complete the sign-in (or set GEMINI_API_KEY), then try again — or switch to another assistant.';
+}
+//# sourceMappingURL=agent-failure.js.map

package/dist/agent-isolation.d.ts

@@ -0,0 +1,17 @@
+export declare const CLAUDE_ISOLATION_ARGUMENTS: readonly ["--strict-mcp-config"];
+/** Codex feature flags (see `codex features list`) that bring in the user's plugins and connectors. */
+export declare const CODEX_DISABLED_FEATURES: readonly ["plugins", "apps"];
+/** MCP server names declared in a Codex config.toml, as `[mcp_servers.<name>]` tables or inline entries. */
+export declare function codexConfigMcpServerNames(toml: string): string[];
+/**
+ * MCP servers the user configured for Codex: `$CODEX_HOME/config.toml`
+ * (default `~/.codex`) and the project's own `.codex/config.toml`. Unreadable
+ * files contribute nothing.
+ */
+export declare function codexUserMcpServers(cwd: string, env?: NodeJS.ProcessEnv): Promise<string[]>;
+/**
+ * Codex `exec` options that switch off the user's plugins, connectors, and
+ * MCP servers, keeping only `keep` (Doxloop's capture server).
+ */
+export declare function codexIsolationArguments(userServers?: readonly string[], keep?: readonly string[]): string[];
+//# sourceMappingURL=agent-isolation.d.ts.map

package/dist/agent-isolation.js

@@ -0,0 +1,94 @@
+/**
+ * Doxloop sessions run with Doxloop's own tools only. The user's personal
+ * agent setup (computer-use plugins, browser REPLs, chat connectors) is for
+ * their own work: a research session that reached for a global `cua_repl`
+ * plugin failed repeatedly instead of using the capture browser Doxloop gave
+ * it. The agent's sign-in, model defaults, and skills are left alone.
+ *
+ * Claude Code: `--strict-mcp-config` loads only the servers passed with
+ * `--mcp-config` (the capture browser, when the run has one).
+ * Codex: `--disable plugins` and `--disable apps` turn off plugin- and
+ * app-provided tools, and every MCP server in the user's (and the project's)
+ * config.toml is switched off with `-c mcp_servers.<name>.enabled=false`.
+ * A dedicated CODEX_HOME would lose the user's login, so it is not used.
+ */
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const CLAUDE_ISOLATION_ARGUMENTS = ['--strict-mcp-config'];
+/** Codex feature flags (see `codex features list`) that bring in the user's plugins and connectors. */
+export const CODEX_DISABLED_FEATURES = ['plugins', 'apps'];
+/** MCP server names declared in a Codex config.toml, as `[mcp_servers.<name>]` tables or inline entries. */
+export function codexConfigMcpServerNames(toml) {
+    const names = new Set();
+    let inServersTable = false;
+    for (const rawLine of toml.split(/\r?\n/)) {
+        const line = rawLine.replace(/\s+#.*$/, '').trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const table = /^\[\s*mcp_servers\s*\.\s*(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_-]+))/.exec(line);
+        if (table) {
+            names.add(table[1] ?? table[2] ?? table[3]);
+            inServersTable = false;
+            continue;
+        }
+        if (line.startsWith('[')) {
+            inServersTable = /^\[\s*mcp_servers\s*\]$/.test(line);
+            continue;
+        }
+        const dotted = /^mcp_servers\s*\.\s*(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_-]+))\s*[.=]/.exec(line);
+        if (dotted) {
+            names.add(dotted[1] ?? dotted[2] ?? dotted[3]);
+            continue;
+        }
+        if (inServersTable) {
+            const entry = /^(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_-]+))\s*[.=]/.exec(line);
+            if (entry)
+                names.add(entry[1] ?? entry[2] ?? entry[3]);
+        }
+    }
+    return [...names];
+}
+/**
+ * MCP servers the user configured for Codex: `$CODEX_HOME/config.toml`
+ * (default `~/.codex`) and the project's own `.codex/config.toml`. Unreadable
+ * files contribute nothing.
+ */
+export async function codexUserMcpServers(cwd, env = process.env) {
+    const home = env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+    const names = new Set();
+    for (const file of [join(home, 'config.toml'), join(cwd, '.codex', 'config.toml')]) {
+        try {
+            for (const name of codexConfigMcpServerNames(await readFile(file, 'utf8')))
+                names.add(name);
+        }
+        catch {
+            // No config there.
+        }
+    }
+    return [...names].sort();
+}
+/**
+ * Codex's `-c` dotted paths take bare keys only (a quoted key is read as a
+ * new server named with the quotes), so a name outside [A-Za-z0-9_-] cannot
+ * be switched off from the command line and is left as it is.
+ */
+function overridableServerName(name) {
+    return /^[A-Za-z0-9_-]+$/.test(name);
+}
+/**
+ * Codex `exec` options that switch off the user's plugins, connectors, and
+ * MCP servers, keeping only `keep` (Doxloop's capture server).
+ */
+export function codexIsolationArguments(userServers = [], keep = []) {
+    const args = [];
+    for (const feature of CODEX_DISABLED_FEATURES)
+        args.push('--disable', feature);
+    for (const name of userServers) {
+        if (keep.includes(name) || !overridableServerName(name))
+            continue;
+        args.push('-c', `mcp_servers.${name}.enabled=false`);
+    }
+    return args;
+}
+//# sourceMappingURL=agent-isolation.js.map