Files
ragflow/internal/agent/component/io/txt_writer.go
Zhichang Yu e45659868a feat(agent): ship the Go agent canvas port — eino interrupt/resume + Redis check-pointing (#16035)
Replaces the Python agent canvas runtime with a Go implementation that
runs inside `cmd/server_main`.

The canvas compiles into an eino Workflow that pauses on wait-for-user
via native Interrupt/Resume (no sentinel flag) and resumes from a
Redis-backed CheckPointStore.

All 21 Python agent components and ~35 tools are ported with functional
parity.

Sandbox providers now read their JSON config from the admin-panel
system_settings table with env fallback.

234 files / +35,413 / -6,111. All Go files are gofmt-clean (CI gate
added); drops the v2 DSL E2E step and the gap-analysis plan (both
redundant after the port ships).

## Type of change

- [x] Refactoring
- [x] New feature
- [x] Bug fix

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 13:24:03 +08:00

69 lines
2.0 KiB
Go

//
// Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// Package io — TXT writer.
//
// The TXT writer is the trivial plain-text path: header / footer /
// timestamp are wrapped as plain text lines around the body. No
// encoding negotiation (UTF-8 only); no markdown stripping
// (downstream tools that don't understand markdown can consume TXT
// when the source content is markdown-flavoured — the writer does
// not rewrite the body).
package io
import (
"bytes"
"fmt"
"time"
)
// TXTOptions is the public contract for the TXT writer.
type TXTOptions struct {
HeaderText string
FooterText string
AddTimestamp bool
// Now overrides time.Now() for deterministic tests. Zero value
// means "use the real clock".
Now time.Time
}
// WriteTXT renders plain text per the Python `_generate_txt`
// contract: optional header line, optional "Generated: ..." line,
// body, optional footer line. The shape is byte-exact stable so
// downstream byte-equality tests can pin it.
func WriteTXT(content string, opts TXTOptions) []byte {
now := opts.Now
if now.IsZero() {
now = time.Now().UTC()
}
var b bytes.Buffer
if opts.HeaderText != "" {
b.WriteString(opts.HeaderText)
b.WriteString("\n")
}
if opts.AddTimestamp {
fmt.Fprintf(&b, "Generated: %s\n", now.Format(time.RFC3339))
}
b.WriteString("\n")
b.WriteString(content)
if opts.FooterText != "" {
b.WriteString("\n")
b.WriteString(opts.FooterText)
}
return b.Bytes()
}