An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later
package streams
import "github.com/dop251/goja"
// deferred 包装 rt.NewPromise() 返回的三元组,供需要重复创建、随时 resolve/reject 的内部 Promise
// (如 reader/writer 的 closed、ready)使用。
type deferred struct {
promise *goja.Promise
resolve func(any) error
reject func(any) error
}
func newDeferred(rt *goja.Runtime) deferred {
p, resolve, reject := rt.NewPromise()
return deferred{promise: p, resolve: resolve, reject: reject}
}
// value 返回可暴露给脚本的 Promise 值。
func (d deferred) value(rt *goja.Runtime) goja.Value { return rt.ToValue(d.promise) }
// isPending 返回该 Promise 当前是否仍处于 pending 状态。
func (d deferred) isPending() bool { return d.promise.State() == goja.PromiseStatePending }
// newResolvedPromise 返回一个已经以 value 兑定的 Promise 值。
func newResolvedPromise(rt *goja.Runtime, value goja.Value) goja.Value {
p, resolve, _ := rt.NewPromise()
if err := resolve(value); err != nil {
panic(err)
}
return rt.ToValue(p)
}
// newRejectedPromise 返回一个已经以 reason 拒绝的 Promise 值。
func newRejectedPromise(rt *goja.Runtime, reason goja.Value) goja.Value {
p, _, reject := rt.NewPromise()
if err := reject(reason); err != nil {
panic(err)
}
return rt.ToValue(p)
}
// awaitResult 统一处理"可能是 Promise,也可能是普通值"的结果:result 不是 Promise 时直接以其值调用
// onFulfilled;是 Promise 时注册 then 回调。goja 把 Promise 反应(包括已经 settle 的 Promise 上新注册的
// then 回调)排进内部 job 队列,只在最外层脚本调用整体返回、控制权交还给 Go 的那一刻才循环排空(而不是
// 在 then()/resolve() 调用的当下同步触发),因此 onFulfilled/onRejected 的实际调用时机既不是
// awaitResult 返回前,也不保证在当前 Go 调用栈内——只保证最终会被调用(除非对应的 Promise 永不 settle)。
func awaitResult(rt *goja.Runtime, result goja.Value, onFulfilled func(value goja.Value), onRejected func(reason goja.Value)) {
promise, ok := asPromise(result)
if !ok {
onFulfilled(result)
return
}
object := rt.ToValue(promise).ToObject(rt)
then, ok := goja.AssertFunction(object.Get("then"))
if !ok {
// 不应该发生:goja 的 Promise 对象总有可调用的 then。退化为直接按当前导出值处理,不中断调用方。
onFulfilled(result)
return
}
if _, err := then(object,
rt.ToValue(func(call goja.FunctionCall) goja.Value {
onFulfilled(call.Argument(0))
return goja.Undefined()
}),
rt.ToValue(func(call goja.FunctionCall) goja.Value {
onRejected(call.Argument(0))
return goja.Undefined()
}),
); err != nil {
panic(err)
}
}
// asPromise 判断 value 是否导出为 *goja.Promise。
func asPromise(value goja.Value) (*goja.Promise, bool) {
if value == nil {
return nil, false
}
p, ok := value.Export().(*goja.Promise)
return p, ok
}