fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(agent): harden sub-agent streamline (PR #582 follow-up) - #584

Merged
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening
Jun 3, 2026
Merged

fix(agent): harden sub-agent streamline (PR #582 follow-up)#584
OisinKyne merged 1 commit into
oisin/sell-agent-streamlinefrom
fix/sub-agent-streamline-hardening

Conversation

@bussyjd

Copy link
Copy Markdown
Contributor

Summary

Follow-up hardening for #582 ("Streamline sub-agents"), based on oisin/sell-agent-streamline so it can merge into that branch before #582 lands. Addresses three review findings; no behavior from #582 is reverted — this tightens the contract and adds the coverage that was missing.

Changes

#2 — make the "sub-agents only" marker invariant enforced, not just convention.
The .no-bundled-skills marker is written unconditionally inside SeedHostFiles. It's safe today because all callers are sub-agent paths and the master seeds via internal/hermes, but nothing guarded it. Added a doc-contract on SeedHostFiles plus TestMarkerOnlyWrittenBySeedHostFiles, which proves the marker is written only by SeedHostFiles — never by the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master/objective-only path could route through. A future refactor that pushes the write into a shared primitive fails this test first.

#3 — fix the terminal.timeout / lifetime_seconds inversion.
The rendered sub-agent config had timeout: 180 (per-operation) larger than lifetime_seconds: 90 (whole session) — a single op was nominally allowed to outlive the session. Lowered terminal.timeout to 80 (≤ 90, well under the 100s Cloudflare free-tunnel cap). The render test now parses both values and asserts timeout <= lifetime_seconds rather than only checking literals, so the relation is enforced even if the numbers drift.

#1 — verify the Hermes image actually honors the streamlined contract.
Existing unit tests only assert our rendered output contains the marker + capped keys; nothing proved nousresearch/hermes-agent:v2026.5.28 respects them. Added a //go:build integration test that deploys a real CRD sub-agent via obol agent new and asserts end-to-end:

  1. the .no-bundled-skills marker on the host PVC path and visible inside the pod;
  2. the capped hermes-config keys (lifetime_seconds: 90, max_turns: 30, reasoning_effort: low, disabled_toolsets: [memory, web]);
  3. a behavioral bundled-skills-skipped signal — obol-skills external dir populated while the native bundled-skills dir is absent/empty (chosen over a brittle log-grep on an external image's wording).

It t.Skips gracefully without a cluster, consistent with the rest of the integration suite. The optional in-pod inference exercise is gated on OBOL_LLM_ENDPOINT.

Docs.plans/sell-agent-perf.md gets a post-review hardening section and corrected measured figures (SOUL.md template 2128 → 1460 bytes / ~370 tok — the earlier "~1050 → ~500 tok" was optimistic; addresses split preserved all 177 unique addresses across 8 reference files, verified by diff).

Test evidence

gofmt -l (touched pkgs) → clean
go build ./... → OK
go test ./internal/agentcrd/ ./internal/serviceoffercontroller/ ./internal/hermes/ → ok
TestMarkerOnlyWrittenBySeedHostFiles → PASS (3 subtests)
TestRenderHermesConfig_SubAgentConstraints → PASS
go vet -tags integration ./internal/agentcrd/ ./internal/serviceoffercontroller/ → OK (integration test compiles)

Notes

  • The master agent's config still renders timeout: 180 / lifetime: 300 — intentionally untouched: it isn't tunnel-exposed and 180 ≤ 300 is internally coherent, so User facing ingress #3's tunnel rationale doesn't apply.
  • To run the integration test live: go test -tags integration -run TestIntegration_AgentContract -v -timeout 15m ./internal/agentcrd/ against a cluster from obol stack up.

Addresses review findings #1/#2/#3 on PR #582 "Streamline sub-agents".
- agentcrd: document the SeedHostFiles "sub-agents-for-sale only" contract
and add TestMarkerOnlyWrittenBySeedHostFiles, locking that the
.no-bundled-skills marker is written only by SeedHostFiles and never by
the reusable seed primitives (WriteSoul, embed.WriteSkillSubset) a master
or objective-only path could route through. [finding #2]
- serviceoffercontroller: lower the rendered terminal.timeout 180 -> 80 so a
single operation can no longer outlive the 90s lifetime_seconds session;
the render test now parses both and asserts timeout <= lifetime_seconds. [finding #3]
- agentcrd: add a //go:build integration test that deploys a real CRD
sub-agent and verifies the Hermes image honors the contract end-to-end:
the marker on the PVC and visible in-pod, the capped hermes-config keys
(lifetime_seconds/max_turns/reasoning_effort/disabled_toolsets), and a
behavioral bundled-skills-skipped signal. Skips gracefully without a
cluster. [finding #1]
- plans/sell-agent-perf.md: post-review hardening section and corrected
measured figures (SOUL.md 2128 -> 1460 bytes ~370 tok; 177 addresses
preserved across 8 reference files).
@bussyjd
bussyjd requested a review from OisinKyneJune 3, 2026 13:26
@OisinKyne
OisinKyne merged commit fe47093 into oisin/sell-agent-streamlineJun 3, 2026
@OisinKyne
OisinKyne deleted the fix/sub-agent-streamline-hardening branch June 3, 2026 14:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@bussyjd@OisinKyne