From cfac40ebe4222bff4eb165cf3f7d641513a725e1 Mon Sep 17 00:00:00 2001
From: Anthony Ettinger <anthony@chovy.com>
Date: Sat, 6 Jun 2026 15:54:08 +0000
Subject: [PATCH] Add AgentByte screening plugin spec

---
 apps/logicsrc-web/src/main.ts    |  41 +++++
 apps/logicsrc-web/src/styles.css |   9 +
 docs/agent-screening.md          | 286 +++++++++++++++++++++++++++++++
 docs/plugins.md                  |   4 +
 4 files changed, 340 insertions(+)
 create mode 100644 docs/agent-screening.md

diff --git a/apps/logicsrc-web/src/main.ts b/apps/logicsrc-web/src/main.ts
index ab55136..c988e24 100644
--- a/apps/logicsrc-web/src/main.ts
+++ b/apps/logicsrc-web/src/main.ts
@@ -30,6 +30,13 @@ const upcoming = [
   { name: "GitHub integration", detail: "Target Profullstack repos, create issues and branches, and keep task history auditable." }
 ];
 
+const agentByteSurfaces = [
+  { name: "CLI", detail: "`logicsrc agentbyte` for plans, sessions, scorecards, audits, and artifacts." },
+  { name: "TUI", detail: "Terminal panes for live transcripts, policy events, model use, evidence, and scorecards." },
+  { name: "SDKs", detail: "Rust, Bun, Node, Python, and curl surfaces with the same screening session API." },
+  { name: "PWA", detail: "Plan builder, candidate intake, live screening room, artifact review, and decision packet." }
+];
+
 document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
   <main class="shell">
     <aside class="rail">
@@ -44,6 +51,7 @@ document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
         <a class="active" href="#overview">Overview</a>
         <a href="#schemas">Schemas</a>
         <a href="/agent-swarm">Soon</a>
+        <a href="/agentbyte">AgentByte</a>
         <a href="#cli">CLI</a>
         <a href="#reference">Reference</a>
       </nav>
@@ -103,6 +111,35 @@ document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
         </div>
       </section>
 
+      <section id="agentbyte" class="band coming-soon agentbyte">
+        <div class="section-head">
+          <h2>AgentByte</h2>
+          <p>A coming-soon LogicSRC plugin spec for AI-era screening, assessments, interviews, and auditable agent-assisted answers.</p>
+        </div>
+        <div class="soon-layout">
+          <article class="soon-lead">
+            <span>slug: agentbyte</span>
+            <h3>Screening where AI use is declared, measured, and auditable</h3>
+            <p>AgentByte defines open screening sessions for humans, AI-assisted humans, autonomous agents, and human-agent pairs. Instead of pretending AI is absent, the spec records model use, tools, artifacts, scorecards, policy decisions, and evidence.</p>
+            <pre><code>logicsrc agentbyte plan create \\
+  --role "AI Engineer" \\
+  --repo profullstack/logicsrc
+
+logicsrc agentbyte session audit \\
+  --session ssn_123 \\
+  --format markdown</code></pre>
+          </article>
+          <div class="soon-grid">
+            ${agentByteSurfaces.map((item) => `
+              <article>
+                <h3>${item.name}</h3>
+                <p>${item.detail}</p>
+              </article>
+            `).join("")}
+          </div>
+        </div>
+      </section>
+
       <section id="schemas" class="band two-col">
         <div>
           <div class="section-head">
@@ -157,3 +194,7 @@ if ("serviceWorker" in navigator) {
 if (window.location.pathname === "/agent-swarm") {
   document.querySelector("#agent-swarm")?.scrollIntoView();
 }
+
+if (window.location.pathname === "/agentbyte") {
+  document.querySelector("#agentbyte")?.scrollIntoView();
+}
diff --git a/apps/logicsrc-web/src/styles.css b/apps/logicsrc-web/src/styles.css
index 5595dc0..03238d9 100644
--- a/apps/logicsrc-web/src/styles.css
+++ b/apps/logicsrc-web/src/styles.css
@@ -229,6 +229,15 @@ h1 {
   background: #eef7f3;
 }
 
+.agentbyte .soon-lead {
+  background: #f7f3e8;
+}
+
+.agentbyte .soon-lead span {
+  border-color: #e3c878;
+  color: #735b14;
+}
+
 .soon-lead span {
   display: inline-block;
   margin-bottom: 0.75rem;
diff --git a/docs/agent-screening.md b/docs/agent-screening.md
new file mode 100644
index 0000000..8efa79a
--- /dev/null
+++ b/docs/agent-screening.md
@@ -0,0 +1,286 @@
+# AgentByte Plugin Spec
+
+Status: coming soon
+
+Slug: `agentbyte`
+
+AgentByte is a working-title LogicSRC plugin spec for interoperable screening workflows in the AI era. It is intended for candidate screening, contractor qualification, agent capability checks, team upskilling, and marketplace trust.
+
+The spec assumes both humans and AI agents may participate. AI assistance is not treated as cheating by default; it is declared, measured, constrained, and audited by policy.
+
+## Goals
+
+- Turn job descriptions, project needs, and role requirements into structured screening plans.
+- Support human, AI-assisted human, autonomous agent, and hybrid candidate modes.
+- Record what tools, models, prompts, files, repos, and external resources were used.
+- Produce portable scorecards, evidence, transcripts, artifacts, and replayable audit logs.
+- Let products implement screening without owning the standard.
+
+## Core Objects
+
+```txt
+screening_profile
+screening_plan
+screening_session
+screening_question
+screening_challenge
+screening_answer
+screening_artifact
+screening_scorecard
+screening_policy
+screening_proctor_event
+screening_model_use
+screening_decision
+```
+
+## Candidate Modes
+
+```txt
+human_only
+human_ai_assisted
+agent_only
+human_agent_pair
+team
+```
+
+## Policy Fields
+
+```txt
+ai_allowed
+allowed_models
+blocked_models
+allowed_tools
+blocked_tools
+internet_allowed
+repo_access
+time_limit_seconds
+recording_required
+human_attestation_required
+agent_attestation_required
+evidence_required
+```
+
+## CLI Spec
+
+Command namespace:
+
+```bash
+logicsrc agentbyte <command>
+```
+
+Required commands:
+
+```txt
+plan create
+plan get
+session start
+session submit
+session score
+session audit
+policy validate
+artifact attach
+export scorecard
+```
+
+Examples:
+
+```bash
+logicsrc agentbyte plan create --role "AI Engineer" --repo profullstack/logicsrc
+logicsrc agentbyte session start --plan plan_123 --candidate did:agent.qa
+logicsrc agentbyte session submit --session ssn_123 --artifact ./patch.diff
+logicsrc agentbyte session audit --session ssn_123 --format markdown
+```
+
+## TUI Spec
+
+Required panes:
+
+```txt
+plans
+sessions
+live transcript
+questions/challenges
+artifacts
+model/tool use
+scorecard
+audit events
+policy violations
+```
+
+Required actions:
+
+```txt
+start session
+pause session
+attach artifact
+request clarification
+mark evidence
+score criterion
+flag policy event
+export scorecard
+```
+
+## SDK Spec
+
+All SDKs should expose the same conceptual API:
+
+```txt
+createPlan(input)
+getPlan(id)
+startSession(planId, candidate)
+submitAnswer(sessionId, answer)
+attachArtifact(sessionId, artifact)
+recordModelUse(sessionId, modelUse)
+scoreSession(sessionId, scorecard)
+exportAudit(sessionId)
+```
+
+### Rust
+
+Package target: `agentbyte`
+
+```rust
+let client = ScreeningClient::new(config);
+let plan = client.create_plan(plan_input).await?;
+let session = client.start_session(&plan.id, candidate).await?;
+```
+
+### Bun
+
+Package target: `@profullstack/agentbyte-bun`
+
+```ts
+const client = new ScreeningClient({ apiKey });
+const plan = await client.createPlan(input);
+const session = await client.startSession(plan.id, candidate);
+```
+
+### Node
+
+Package target: `@profullstack/agentbyte-node`
+
+```ts
+import { ScreeningClient } from "@profullstack/agentbyte-node";
+
+const client = new ScreeningClient({ apiKey });
+await client.recordModelUse(sessionId, modelUse);
+```
+
+### Python
+
+Package target: `profullstack-agentbyte`
+
+```python
+client = ScreeningClient(api_key=api_key)
+plan = client.create_plan(input)
+session = client.start_session(plan["id"], candidate)
+```
+
+### curl
+
+HTTP surface:
+
+```bash
+curl -X POST "$LOGICSRC_API/agentbyte/plans" \
+  -H "authorization: Bearer $TOKEN" \
+  -H "content-type: application/json" \
+  -d @plan.json
+```
+
+Required endpoints:
+
+```txt
+POST /agentbyte/plans
+GET /agentbyte/plans/:id
+POST /agentbyte/sessions
+GET /agentbyte/sessions/:id
+POST /agentbyte/sessions/:id/answers
+POST /agentbyte/sessions/:id/artifacts
+POST /agentbyte/sessions/:id/model-use
+POST /agentbyte/sessions/:id/score
+GET /agentbyte/sessions/:id/audit
+```
+
+## PWA Spec
+
+Required views:
+
+```txt
+plan builder
+candidate intake
+live screening room
+challenge workspace
+model/tool-use disclosure
+artifact review
+scorecard editor
+audit timeline
+decision packet
+```
+
+Required states:
+
+```txt
+draft
+scheduled
+active
+paused
+submitted
+scoring
+reviewed
+decided
+disputed
+archived
+```
+
+## MCP Spec
+
+Resources:
+
+```txt
+agentbyte://plans
+agentbyte://sessions
+agentbyte://policies
+agentbyte://scorecards
+agentbyte://audits/{session_id}
+```
+
+Tools:
+
+```txt
+create_agentbyte_plan
+start_agentbyte_session
+submit_agentbyte_answer
+attach_agentbyte_artifact
+record_agentbyte_model_use
+score_agentbyte_session
+export_agentbyte_audit
+```
+
+Prompts:
+
+```txt
+create-agentbyte-plan
+review-agentbyte-artifacts
+summarize-agentbyte-audit
+draft-agentbyte-decision
+```
+
+## Minimum Audit Event Shape
+
+```json
+{
+  "type": "logicsrc.event",
+  "version": "0.1",
+  "event_id": "evt_screening_123",
+  "event_type": "screening.model_use.recorded",
+  "resource_type": "screening_session",
+  "resource_id": "ssn_123",
+  "actor_did": "candidate.example",
+  "created_at": "2026-01-01T00:00:00.000Z",
+  "metadata": {
+    "model": "provider/model",
+    "purpose": "answer_assistance",
+    "policy_allowed": true
+  }
+}
+```
diff --git a/docs/plugins.md b/docs/plugins.md
index 0e17e56..839a50a 100644
--- a/docs/plugins.md
+++ b/docs/plugins.md
@@ -8,6 +8,10 @@ Default plugins:
 - uGig: job import, gig publishing, candidate/agent linking, bid sync, marketplace publishing, and reputation sync.
 - sh1pt: project sync, action publishing, release tracking, deployment status, artifact sync, and delivery reputation.
 
+Coming soon plugin specs:
+
+- AgentByte: candidate, contractor, and agent capability screening for AI-era workflows. See `docs/agent-screening.md`.
+
 Runtime requirements:
 
 - Validate plugin manifests.