Skip to content

Release 0.5.2: agent sign-in guidance in login help - #23

Merged
eddiearc merged 7 commits into
mainfrom
docs/login-agent-help-20260910
Sep 10, 2026
Merged

eddiearc merged 7 commits into
mainfrom
docs/login-agent-help-20260910

Conversation

@eddiearc

@eddiearc eddiearc commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

aisa login --help now explains the browser/headless sign-in handoff that previously lived in a long Quickstart. Agents can consult command help, immediately relay the actual authorization URL, reuse the running login, accept only its one-time result, recover expired sessions, choose native MCP without a persistent terminal, and verify balance before claiming connection.

Login help change: two existing files,+17 lines. src/commands/oauth-login.ts provides the help text; src/index.ts attaches it through Commander. Login flags, OAuth implementation, credential storage, endpoints and paid-tool behavior are unchanged. Existing command compatibility is retained; published0.5.2 delivers this expanded help to installed users.

Review map against d88cc10 at69257ee:14 files,+512/-18, divided without overlap:

Category Added / removed lines
Login help/registration 17 /0
Version metadata/constants 4 /4
Changelog/release links 20 /1
Release operator guide 13 /13
Manual eval code/guards 336 /0
Fixed cases/rubric/baseline 66 /0
Eval README 56 /0

The focused eval/agent-quickstart/login-handoff/ entry is outside the118-file npm payload and leaves the existing business eval unchanged. Its guards distinguish real help from mocked login, refuse invalid/duplicate input, preserve all failed runs, and prevent model execution by default. It adds no production auth layer.

Validation:308 existing tests; all five Node18/20/22/24/26 CI jobs and package smoke pass. Two real packed/install arms differ only in the help registration. Final real-Agent/tool result: full5/5, ablated2/5 by frozen semantic rubric (mechanical5/5 vs4/5). The control omits the current URL/chat handoff and attempts unavailable login. Auth/PTY/balance are synthetic, not live OAuth. R0/R1 failures and scoped fixes are preserved; no selective row replacement or universal reliability claim. Results and reproduction.

Companions: Skill PR51 provides a short help-first Sign-in section; Docs PR100 shortens bootstrap and preserves the direct-HTTP paid-approval contract.

Released as0.5.2. The user authorized this merge and publication. Reviewed head69257ee was squash-merged asf012ee6e0175febef098e79c2c819a78ba92d133; merged-main CI passed and the tree matched the reviewed candidate. Fresh annotatedv0.5.2 points to that merge. The unchanged OIDC Release workflow succeeded.

Official npm metadata confirms version/latest0.5.2. The downloaded registry archive passed SHA512/SHA1 verification; SHA256e3988cf3ebf1973e5a4ba1c2bae9dc46ec4f9869277e40a992130ab282b7085a. All118 payload files match the final reviewed candidate; eval/source/tests are absent. Published-archive installation passes45 smoke checks; installed login help is byte-identical to reviewed R2 help. No local npm publish, retag, global CLI replacement or production AIsa auth/data call was used.

Release evidence. Skill PR51 is already merged. Docs PR100 and user-journey-evals PR14 remain unmerged; this release does not authorize their merge.

Commander after-help only. Flags, description, and OAuth runtime unchanged.
Unpublished 0.5.1 candidate; do not treat as released.
No TTY uses native MCP OAuth. Agents paste a one-time code once, never a
key or token. Connected only after login and a successful balance check.
R1 read help then started another login --no-browser instead of
sending the result to the live PTY. Help only; runtime unchanged.
Version metadata and changelog only. Auth runtime, help body, and
default-off login-handoff eval are unchanged. Not tagged or published.
Point Unreleased at v0.5.2...HEAD and add [0.5.2] v0.5.1...v0.5.2.
@eddiearc eddiearc changed the title docs: make login help own the agent sign-in handoff Release 0.5.2: agent sign-in guidance in login help Sep 10, 2026
@eddiearc
eddiearc marked this pull request as ready for review September 10, 2026 06:08
@eddiearc
eddiearc merged commit f012ee6 into main Sep 10, 2026
5 checks passed
Sign up for free to 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.

1 participant