3fb3583a92
Close the v0.2 RAG demo loop and ship the validation infrastructure:
- weknora api <method> <path> [--data X | --data-file F]
Raw passthrough wrapping client.Raw, gh-style. JSON envelope mode
surfaces status / headers / parsed body. Non-2xx routes through
cmdutil.ClassifyHTTPStatus (factored out of ClassifyHTTPError so
both SDK-error and direct-status paths stay aligned — reuse review).
- weknora chat <text> [--session-id S] [--no-stream]
KnowledgeQAStream consumer with two output modes:
- TTY default: token streaming + references footer
- --json / --no-stream / non-TTY: buffered single envelope
Auto-creates a session when --session-id is omitted; the id prints
to stderr at start AND on stream failure (^C scrolls past the
first announcement, so the recovery hint is re-surfaced when the
user is most likely to need it).
- cli/internal/sse/Accumulator
buffers Content / References / SessionID across SDK callbacks.
Idempotent post-Done so misbehaving servers don't corrupt state.
- doctor: ok → ok / warn / fail / skip
warn marks soft issues that don't block: server within compat range
but >=1 minor behind CLI; credential storage falling back to file
because keyring is unavailable. Envelope.ok stays true on warn,
flips false on fail (exit 1). doctor.error_network golden updated.
- cli/acceptance/e2e/ real-server RAG full loop
Build-tagged //go:build acceptance_e2e — kept out of the default
`go test ./...`. Exercises kb create → doc upload → poll ready →
search → chat → cleanup against a server pointed at by
WEKNORA_E2E_HOST / _TOKEN.
- .github/workflows/cli-e2e.yml
manual workflow_dispatch + label-gated PR trigger
("acceptance-e2e"). No-ops gracefully when the secrets aren't set
so cross-fork PRs can't accidentally fail the suite.
59 lines
1.9 KiB
Go
59 lines
1.9 KiB
Go
// Package sse provides helpers for consuming server-sent event streams from
|
|
// the WeKnora SDK (KnowledgeQAStream, ContinueStream).
|
|
//
|
|
// Accumulator is the canonical sink: every callback event appends to a
|
|
// buffered Content string and updates terminal-state fields like References
|
|
// and SessionID. The non-streaming JSON envelope mode reads .Result() once
|
|
// .Done() is true; streaming mode writes Content tokens directly to stdout
|
|
// and only consults the accumulator for the final References footer.
|
|
package sse
|
|
|
|
import (
|
|
"strings"
|
|
|
|
sdk "github.com/Tencent/WeKnora/client"
|
|
)
|
|
|
|
// Accumulator buffers a KnowledgeQAStream callback sequence.
|
|
//
|
|
// Zero value is ready to use. Not safe for concurrent Append calls — the SDK
|
|
// invokes its callback sequentially on a single goroutine, so this matches
|
|
// the only contract that exists today.
|
|
type Accumulator struct {
|
|
builder strings.Builder
|
|
References []*sdk.SearchResult
|
|
SessionID string
|
|
AssistantMessageID string
|
|
finished bool
|
|
}
|
|
|
|
// Append consumes one StreamResponse event. Safe to call multiple times;
|
|
// idempotent post-Done so callers do not need to special-case late events.
|
|
func (a *Accumulator) Append(r *sdk.StreamResponse) {
|
|
if r == nil || a.finished {
|
|
return
|
|
}
|
|
if r.Content != "" {
|
|
a.builder.WriteString(r.Content)
|
|
}
|
|
if r.SessionID != "" && a.SessionID == "" {
|
|
a.SessionID = r.SessionID
|
|
}
|
|
if r.AssistantMessageID != "" && a.AssistantMessageID == "" {
|
|
a.AssistantMessageID = r.AssistantMessageID
|
|
}
|
|
if r.Done {
|
|
// Terminal events carry References; capture once.
|
|
if r.KnowledgeReferences != nil {
|
|
a.References = r.KnowledgeReferences
|
|
}
|
|
a.finished = true
|
|
}
|
|
}
|
|
|
|
// Done reports whether a terminal event was observed.
|
|
func (a *Accumulator) Done() bool { return a.finished }
|
|
|
|
// Result returns the concatenated content string.
|
|
func (a *Accumulator) Result() string { return a.builder.String() }
|