fix: preserve table copy auth recovery

CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to this project will be documented in this file.
 
+## [v1.0.81] - 2026-07-31
+
+### Features
+
+- support visible_rule for form questions (#1891)
+- **contact**: add bot search shortcut (#2083)
+- add SXSD schema validation to Slides lint (#2103)
+- **drive**: add comment-operation shortcuts (#1898)
+- **drive**: extend permission shortcuts for Miaoda (#2070)
+- **apps**: add cache debug commands (+cache-get/-delete/-clear) (#1896)
+- support source file preview artifacts (#2085)
+
+### Bug Fixes
+
+- **contact**: stop bot match segments carrying tags or empty entries (#2115)
+- **base**: resolve Base URL block types accurately (#2099)
+- **drive**: use title for default download filename (#2089)
+- drop stale target version from root upgrade prompt (#2100)
+
+### Documentation
+
+- **calendar**: warn against container-default timezone in time conversion (#2104)
+- **calendar**: confirm scope before editing recurring events (#2119)
+- **base**: clarify form and file operation routing (#2110)
+
+### Misc
+
+- add protected public domain allowlists (#2111)
+
 ## [v1.0.80] - 2026-07-29
 
 ### Features
@@ -1722,6 +1751,7 @@ Bundled AI agent skills for intelligent assistance:
 - Bilingual documentation (English & Chinese).
 - CI/CD pipelines: linting, testing, coverage reporting, and automated releases.
 
+[v1.0.81]: https://github.com/larksuite/cli/releases/tag/v1.0.81
 [v1.0.80]: https://github.com/larksuite/cli/releases/tag/v1.0.80
 [v1.0.79]: https://github.com/larksuite/cli/releases/tag/v1.0.79
 [v1.0.78]: https://github.com/larksuite/cli/releases/tag/v1.0.78

README.md

@@ -310,10 +310,6 @@ lark-cli config risk-control default
 
 Please fully understand all usage risks. By using this tool, you are deemed to voluntarily assume all related responsibilities.
 
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=larksuite/cli&type=Date)](https://star-history.com/#larksuite/cli&Date)
-
 ## Contributing
 
 Community contributions are welcome! If you find a bug or have feature suggestions, please submit an [Issue](https://github.com/larksuite/cli/issues) or [Pull Request](https://github.com/larksuite/cli/pulls).

README.zh.md

@@ -311,10 +311,6 @@ lark-cli config risk-control default
 
 请您充分知悉全部使用风险，使用本工具即视为您自愿承担相关所有责任。
 
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=larksuite/cli&type=Date)](https://star-history.com/#larksuite/cli&Date)
-
 ## 贡献
 
 欢迎社区贡献！如果你发现 bug 或有功能建议，请提交 [Issue](https://github.com/larksuite/cli/issues) 或 [Pull Request](https://github.com/larksuite/cli/pulls)。

cmd/build.go

@@ -20,6 +20,7 @@ import (
 	"github.com/larksuite/cli/cmd/skill"
 	cmdupdate "github.com/larksuite/cli/cmd/update"
 	"github.com/larksuite/cli/cmd/whoami"
+	_ "github.com/larksuite/cli/events"
 	"github.com/larksuite/cli/internal/apicatalog"
 	"github.com/larksuite/cli/internal/build"
 	"github.com/larksuite/cli/internal/cmdpolicy"

cmd/config/init_interactive.go

@@ -179,8 +179,8 @@ func runCreateAppFlow(ctx context.Context, f *cmdutil.Factory, brandOverride cor
 	}
 
 	// Step 1: Request app registration (begin)
-	// Use the shared proxy-plugin-aware transport so registration traffic is not
-	// a bypass of proxy plugin mode.
+	// Registration is platform traffic, so it must use the provider-aware
+	// transport as well as the shared proxy configuration.
 	httpClient := transport.NewHTTPClient(0)
 	authResp, err := larkauth.RequestAppRegistration(ctx, httpClient, larkBrand, f.IOStreams.ErrOut)
 	if err != nil {

cmd/doctor/doctor.go

@@ -157,8 +157,8 @@ func networkChecks(ctx context.Context, opts *DoctorOptions, ep core.Endpoints)
 		}
 	}
 
-	// Use the shared proxy-plugin-aware transport so connectivity checks reflect
-	// the real egress path (and are blocked when proxy plugin fails closed).
+	// Connectivity checks are platform traffic and must exercise the same
+	// provider-aware route as real platform requests.
 	httpClient := transport.NewHTTPClient(0)
 	mcpURL := ep.MCP + "/mcp"
 

cmd/event/bus.go

@@ -16,14 +16,12 @@ import (
 	"github.com/larksuite/cli/internal/cmdutil"
 	"github.com/larksuite/cli/internal/core"
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/adapter/lark/websocket"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/transport"
 	"github.com/larksuite/cli/internal/event/bus"
-	"github.com/larksuite/cli/internal/event/catalog"
+	"github.com/larksuite/cli/internal/event/transport"
 )
 
 // NewCmdBus creates the hidden `event _bus` daemon subcommand, forked by the consume client; fork argv lives in consume/startup.go.
-func NewCmdBus(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
+func NewCmdBus(f *cmdutil.Factory) *cobra.Command {
 	var domain string
 
 	cmd := &cobra.Command{
@@ -46,13 +44,7 @@ func NewCmdBus(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
 			}
 
 			tr := transport.New()
-			ingress := &websocket.FeishuSource{
-				AppID:     cfg.AppID,
-				AppSecret: cfg.AppSecret,
-				Domain:    domain,
-				Logger:    logger,
-			}
-			b := bus.NewBus(cfg.AppID, cfg.AppSecret, domain, tr, logger, snap, ingress)
+			b := bus.NewBus(cfg.AppID, cfg.AppSecret, domain, tr, logger)
 
 			ctx, cancel := context.WithCancel(cmd.Context())
 			defer cancel()

cmd/event/bus_test.go

@@ -27,7 +27,7 @@ func TestBusCommandLoggerSetupFailureIsTypedFileIO(t *testing.T) {
 	f, _, _, _ := cmdutil.TestFactory(t, &core.CliConfig{
 		AppID: "cli_bus_test", AppSecret: "secret", Brand: core.BrandFeishu,
 	})
-	cmd := NewCmdBus(f, compileCatalog())
+	cmd := NewCmdBus(f)
 	cmd.SetArgs([]string{})
 
 	err := cmd.Execute()

cmd/event/consume.go

@@ -16,7 +16,6 @@ import (
 
 	"github.com/spf13/cobra"
 
-	"github.com/larksuite/cli/cmd/event/render"
 	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/appmeta"
 	"github.com/larksuite/cli/internal/auth"
@@ -24,10 +23,8 @@ import (
 	"github.com/larksuite/cli/internal/core"
 	"github.com/larksuite/cli/internal/credential"
 	eventlib "github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/transport"
-	appconsume "github.com/larksuite/cli/internal/event/application/consume"
-	"github.com/larksuite/cli/internal/event/catalog"
 	"github.com/larksuite/cli/internal/event/consume"
+	"github.com/larksuite/cli/internal/event/transport"
 	"github.com/larksuite/cli/internal/output"
 	"github.com/larksuite/cli/internal/validate"
 )
@@ -40,10 +37,9 @@ type consumeCmdOpts struct {
 
 	maxEvents int
 	timeout   time.Duration
-	dryRun    bool
 }
 
-func NewCmdConsume(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
+func NewCmdConsume(f *cmdutil.Factory) *cobra.Command {
 	var o consumeCmdOpts
 
 	cmd := &cobra.Command{
@@ -61,7 +57,7 @@ Use 'event list' to see all available EventKeys.
 Use 'event schema <EventKey>' for parameter details.`,
 		Args: cobra.ExactArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
-			return runConsume(cmd, f, snap, args[0], o)
+			return runConsume(cmd, f, args[0], o)
 		},
 	}
 
@@ -70,7 +66,6 @@ Use 'event schema <EventKey>' for parameter details.`,
 	cmd.Flags().BoolVar(&o.quiet, "quiet", false, "Suppress informational messages on stderr")
 	cmd.Flags().StringVar(&o.outputDir, "output-dir", "", "Write each event as a file in this directory (relative paths only; absolute paths and ~ are rejected to prevent path traversal)")
 	cmd.Flags().IntVar(&o.maxEvents, "max-events", 0, "Exit after N successful emits (0 = unlimited). Multi-worker EventKeys may emit up to workers-1 past N before all workers stop. Bounded runs ignore stdin EOF.")
-	cmd.Flags().BoolVar(&o.dryRun, "dry-run", false, "Decide and preview the consume (identity, preconditions, side effects) without performing any of them, then exit")
 	cmd.Flags().DurationVar(&o.timeout, "timeout", 0, "Exit after DURATION (e.g. 30s, 2m). 0 = no timeout. Timeout is a normal exit (code 0; stderr 'reason: timeout'). Bounded runs ignore stdin EOF.")
 	cmd.Flags().String("as", "auto", "identity type: user | bot | auto (must match EventKey's declared AuthTypes)")
 	_ = cmd.RegisterFlagCompletionFunc("as", func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective) {
@@ -81,7 +76,7 @@ Use 'event schema <EventKey>' for parameter details.`,
 	return cmd
 }
 
-func runConsume(cmd *cobra.Command, f *cmdutil.Factory, snap *catalog.Snapshot, eventKey string, o consumeCmdOpts) error {
+func runConsume(cmd *cobra.Command, f *cmdutil.Factory, eventKey string, o consumeCmdOpts) error {
 	// Pipe-close (e.g. `... | head -n 1`) must reach the EPIPE error path in the loop, not SIGPIPE-kill.
 	ignoreBrokenPipe()
 
@@ -95,11 +90,10 @@ func runConsume(cmd *cobra.Command, f *cmdutil.Factory, snap *catalog.Snapshot,
 		return err
 	}
 
-	entry, ok := snap.Resolve(eventKey)
+	keyDef, ok := eventlib.Lookup(eventKey)
 	if !ok {
-		return unknownEventKeyErr(snap, eventKey)
+		return unknownEventKeyErr(eventKey)
 	}
-	keyDef := entry.Definition()
 
 	identity, err := resolveIdentity(cmd, f, keyDef)
 	if err != nil {
@@ -126,16 +120,9 @@ func runConsume(cmd *cobra.Command, f *cmdutil.Factory, snap *catalog.Snapshot,
 
 	domain := core.ResolveEndpoints(cfg.Brand).Open
 
-	// Surface auth errors before forking the bus daemon. A dry run instead
-	// reports the unusable credential as a blocked precondition: the caller
-	// asked what would happen, and "a real run would refuse to authenticate"
-	// is a legitimate part of that answer.
-	var tokenErr error
+	// Surface auth errors before forking the bus daemon.
 	if _, err := resolveTenantToken(cmd.Context(), f, cfg.AppID); err != nil {
-		if !o.dryRun {
-			return err
-		}
-		tokenErr = err
+		return err
 	}
 
 	apiClient, err := f.NewAPIClient()
@@ -182,31 +169,11 @@ func runConsume(cmd *cobra.Command, f *cmdutil.Factory, snap *catalog.Snapshot,
 		appVer:              appVer,
 		subscribedCallbacks: subscribedCallbacks,
 	}
-
-	svc := &appconsume.Service{
-		Strategies: consumeStrategies,
-		Identity:   identityResolverFunc(func(context.Context, *catalog.Entry) (string, error) { return string(identity), nil }),
-		Preflight: preflightReaderFunc(func(ctx context.Context, _ *catalog.Entry, _ string) ([]appconsume.Precondition, error) {
-			return readPreconditions(ctx, pf, appVerErr, tokenErr), nil
-		}),
-	}
-	req := appconsume.Request{
-		EventKey:  eventKey,
-		Params:    paramMap,
-		JQExpr:    o.jqExpr,
-		OutputDir: outputDir,
-		DryRun:    o.dryRun,
-		MaxEvents: o.maxEvents,
-		Timeout:   o.timeout,
-		IsTTY:     f.IOStreams.IsTerminal,
-	}
-	decision, err := svc.Decide(cmd.Context(), entry, req, appconsume.ExecutionContext{API: runtime})
-	if err != nil {
+	if err := preflightEventTypes(pf); err != nil {
 		return err
 	}
-
-	if o.dryRun {
-		return render.WriteDecisionJSON(f.IOStreams.Out, f.IOStreams.ErrOut, string(identity), decision.View())
+	if err := preflightScopes(cmd.Context(), pf); err != nil {
+		return err
 	}
 
 	ctx, cancel := context.WithCancel(cmd.Context())
@@ -237,26 +204,23 @@ func runConsume(cmd *cobra.Command, f *cmdutil.Factory, snap *catalog.Snapshot,
 		watchStdinEOF(os.Stdin, cancel, errOut)
 	}
 
-	runner := streamRunnerFunc(func(ctx context.Context, prepare appconsume.PrepareFunc) error {
-		return consume.Run(ctx, transport.New(), cfg.AppID, cfg.ProfileName, domain, consume.Options{
-			EventKey:         eventKey,
-			Def:              keyDef,
-			Params:           decision.NormalizedParams(),
-			ParamsNormalized: true,
-			JQExpr:           o.jqExpr,
-			Quiet:            o.quiet,
-			OutputDir:        outputDir,
-			Runtime:          runtime,
-			Out:              f.IOStreams.Out,
-			ErrOut:           errOut,
-			RemoteAPIClient:  botRuntime,
-			MaxEvents:        o.maxEvents,
-			Timeout:          o.timeout,
-			IsTTY:            f.IOStreams.IsTerminal,
-			Prepare:          prepare,
-		})
-	})
-	return svc.Execute(ctx, entry, decision, runner, appconsume.ExecutionContext{API: runtime})
+	if err := consume.Run(ctx, transport.New(), cfg.AppID, cfg.ProfileName, domain, consume.Options{
+		EventKey:        eventKey,
+		Params:          paramMap,
+		JQExpr:          o.jqExpr,
+		Quiet:           o.quiet,
+		OutputDir:       outputDir,
+		Runtime:         runtime,
+		Out:             f.IOStreams.Out,
+		ErrOut:          errOut,
+		RemoteAPIClient: botRuntime,
+		MaxEvents:       o.maxEvents,
+		Timeout:         o.timeout,
+		IsTTY:           f.IOStreams.IsTerminal,
+	}); err != nil {
+		return err
+	}
+	return nil
 }
 
 // resolveIdentity resolves the session identity and enforces keyDef.AuthTypes as a whitelist.
@@ -284,14 +248,10 @@ type preflightCtx struct {
 	subscribedCallbacks []string
 }
 
-// preflightScopes compares required scopes against session-available scopes
-// (user: UAT stored; bot: appVer.TenantScopes). checked reports whether a
-// comparison actually happened: "the ledger was unavailable" and "the check
-// passed" are different answers, and only the caller can decide how loudly to
-// say the first one.
-func preflightScopes(ctx context.Context, pf *preflightCtx) (checked bool, err error) {
+// preflightScopes compares required scopes against session-available scopes (user: UAT stored; bot: appVer.TenantScopes).
+func preflightScopes(ctx context.Context, pf *preflightCtx) error {
 	if len(pf.keyDef.Scopes) == 0 || pf.identity == "" {
-		return true, nil
+		return nil
 	}
 	if ctx == nil {
 		ctx = context.Background()
@@ -301,24 +261,24 @@ func preflightScopes(ctx context.Context, pf *preflightCtx) (checked bool, err e
 	switch {
 	case pf.identity.IsBot():
 		if pf.appVer == nil {
-			return false, nil
+			return nil
 		}
 		storedScopes = strings.Join(pf.appVer.TenantScopes, " ")
 	case pf.identity == core.AsUser:
 		result, err := pf.factory.Credential.ResolveToken(ctx, credential.NewTokenSpec(pf.identity, pf.appID))
 		if err != nil || result == nil || result.Scopes == "" {
-			return false, nil //nolint:nilerr // best-effort: the bus handshake surfaces the real auth error
+			return nil //nolint:nilerr // best-effort: bus handshake will surface real auth error
 		}
 		storedScopes = result.Scopes
 	default:
-		return false, nil
+		return nil
 	}
 
 	missing := auth.MissingScopes(storedScopes, pf.keyDef.Scopes)
 	if len(missing) == 0 {
-		return true, nil
+		return nil
 	}
-	return true, errs.NewPermissionError(errs.SubtypeMissingScope,
+	return errs.NewPermissionError(errs.SubtypeMissingScope,
 		"missing required scopes for EventKey %s (as %s): %s",
 		pf.eventKey, pf.identity, strings.Join(missing, ", ")).
 		WithIdentity(string(pf.identity)).

cmd/event/consume_dryrun_test.go

@@ -1,75 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"encoding/json"
-	"os"
-	"path/filepath"
-	"testing"
-
-	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/core"
-)
-
-// A dry run in a degraded environment (the test factory has no reachable
-// platform, so every weak read-only check comes back unanswered) still exits
-// zero with a structured decision that honestly says "unknown" — and performs
-// none of its declared write effects.
-func TestDryRun_DegradedEnvironmentStaysHonestAndSideEffectFree(t *testing.T) {
-	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "cli_test"})
-	snap := compileCatalog()
-
-	tmp := t.TempDir()
-	prevWD, _ := os.Getwd()
-	if err := os.Chdir(tmp); err != nil {
-		t.Fatal(err)
-	}
-	t.Cleanup(func() { _ = os.Chdir(prevWD) })
-
-	cmd := NewCmdConsume(f, snap)
-	cmd.SetArgs([]string{"im.message.receive_v1", "--as", "bot", "--dry-run", "--output-dir", "events-out"})
-	cmd.SilenceUsage = true
-	cmd.SilenceErrors = true
-	if err := cmd.Execute(); err != nil {
-		t.Fatalf("dry-run must not fail on unusable credentials, got: %v", err)
-	}
-
-	var envelope struct {
-		OK     bool `json:"ok"`
-		DryRun bool `json:"dry_run"`
-		Data   struct {
-			Decision struct {
-				Status        string `json:"status"`
-				Preconditions []struct {
-					Name   string `json:"name"`
-					Status string `json:"status"`
-				} `json:"preconditions"`
-				WouldWrite []string `json:"would_write"`
-			} `json:"decision"`
-		} `json:"data"`
-	}
-	if err := json.Unmarshal(stdout.Bytes(), &envelope); err != nil {
-		t.Fatalf("stdout is not a decision envelope: %v\n%s", err, stdout.String())
-	}
-	if !envelope.OK || !envelope.DryRun {
-		t.Errorf("want ok=true dry_run=true, got: %s", stdout.String())
-	}
-	if envelope.Data.Decision.Status != "unknown" {
-		t.Errorf("unanswerable weak checks must render unknown, not fake readiness; got status %q", envelope.Data.Decision.Status)
-	}
-	names := map[string]string{}
-	for _, p := range envelope.Data.Decision.Preconditions {
-		names[p.Name] = p.Status
-	}
-	if names["credentials_available"] == "" || names["console_event_published"] == "" || names["scopes_granted"] == "" {
-		t.Errorf("preconditions must name every check, got: %v", names)
-	}
-
-	// The declared write side effects must stay declarations: the requested
-	// output dir must not exist after a dry run.
-	if _, err := os.Stat(filepath.Join(tmp, "events-out")); !os.IsNotExist(err) {
-		t.Error("dry-run created the output directory; the preview performed a side effect")
-	}
-}

cmd/event/event.go

@@ -18,13 +18,12 @@ func NewCmdEvents(f *cmdutil.Factory) *cobra.Command {
 		SilenceUsage: true,
 	}
 
-	snap := compileCatalog()
-	cmd.AddCommand(NewCmdConsume(f, snap))
-	cmd.AddCommand(NewCmdList(f, snap))
-	cmd.AddCommand(NewCmdSchema(f, snap))
+	cmd.AddCommand(NewCmdConsume(f))
+	cmd.AddCommand(NewCmdList(f))
+	cmd.AddCommand(NewCmdSchema(f))
 	cmd.AddCommand(NewCmdStatus(f))
 	cmd.AddCommand(NewCmdStop(f))
-	cmd.AddCommand(NewCmdBus(f, snap))
+	cmd.AddCommand(NewCmdBus(f))
 
 	return cmd
 }

cmd/event/format_helpers_test.go

@@ -12,7 +12,7 @@ import (
 
 	"github.com/larksuite/cli/internal/cmdutil"
 	"github.com/larksuite/cli/internal/core"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/protocol"
+	"github.com/larksuite/cli/internal/event/protocol"
 	"github.com/larksuite/cli/internal/output"
 )
 
@@ -288,10 +288,9 @@ func errorAs(err error, target interface{}) bool {
 
 func TestNewCmdFactories_WireFlags(t *testing.T) {
 	f, _, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "cli_XXXXXXXXXXXXXXXX"})
-	snap := compileCatalog()
 
 	t.Run("consume", func(t *testing.T) {
-		cmd := NewCmdConsume(f, snap)
+		cmd := NewCmdConsume(f)
 		for _, flag := range []string{"param", "jq", "quiet", "output-dir", "max-events", "timeout", "as"} {
 			if cmd.Flags().Lookup(flag) == nil {
 				t.Errorf("consume missing --%s flag", flag)
@@ -321,22 +320,14 @@ func TestNewCmdFactories_WireFlags(t *testing.T) {
 	})
 
 	t.Run("list", func(t *testing.T) {
-		cmd := NewCmdList(f, snap)
+		cmd := NewCmdList(f)
 		if cmd.Flags().Lookup("json") == nil {
 			t.Error("list missing --json flag")
 		}
-		domainFlag := cmd.Flags().Lookup("domain")
-		if domainFlag == nil {
-			t.Fatal("list missing --domain flag")
-		}
-		wantUsage := "Only list EventKeys of this domain. Valid domains: " + strings.Join(snap.Domains(), ", ")
-		if domainFlag.Usage != wantUsage {
-			t.Errorf("--domain usage = %q, want %q", domainFlag.Usage, wantUsage)
-		}
 	})
 
 	t.Run("bus", func(t *testing.T) {
-		cmd := NewCmdBus(f, snap)
+		cmd := NewCmdBus(f)
 		if !cmd.Hidden {
 			t.Error("bus should be hidden (internal daemon entrypoint)")
 		}

cmd/event/golden_test.go

@@ -1,81 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"flag"
-	"os"
-	"path/filepath"
-	"testing"
-
-	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/core"
-)
-
-var updateGolden = flag.Bool("update", false, "rewrite golden files instead of comparing")
-
-// goldenSchemaKeys picks one key per rendering path so every branch of the
-// list/schema output stays pinned: a processed key with a flat custom schema,
-// a native key with field overrides, a callback key with a single consumer,
-// and a key with a required parameter plus a pre-consume hook.
-var goldenSchemaKeys = map[string]string{
-	"schema_im_message_receive":  "im.message.receive_v1",
-	"schema_im_chat_updated":     "im.chat.updated_v1",
-	"schema_card_action_trigger": "card.action.trigger",
-	"schema_board_whiteboard":    "board.whiteboard.updated_v1",
-}
-
-// The golden files pin stdout byte-for-byte. The output is deterministic:
-// the snapshot keeps keys sorted, encoding/json sorts object keys, and nothing
-// on the rendering path reads the clock or randomness. Regenerate with:
-//
-//	go test ./cmd/event/ -run TestGolden -update
-func TestGolden_ListOutput(t *testing.T) {
-	snap := compileCatalog()
-	for name, asJSON := range map[string]bool{"list_text": false, "list_json": true} {
-		t.Run(name, func(t *testing.T) {
-			f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-			if err := runList(f, snap, "", asJSON); err != nil {
-				t.Fatalf("runList: %v", err)
-			}
-			assertGolden(t, name, stdout.String())
-		})
-	}
-}
-
-func TestGolden_SchemaOutput(t *testing.T) {
-	snap := compileCatalog()
-	for name, key := range goldenSchemaKeys {
-		for suffix, asJSON := range map[string]bool{"_text": false, "_json": true} {
-			t.Run(name+suffix, func(t *testing.T) {
-				f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-				if err := runSchema(f, snap, key, asJSON); err != nil {
-					t.Fatalf("runSchema(%s): %v", key, err)
-				}
-				assertGolden(t, name+suffix, stdout.String())
-			})
-		}
-	}
-}
-
-func assertGolden(t *testing.T, name, got string) {
-	t.Helper()
-	path := filepath.Join("testdata", "golden", name+".golden")
-	if *updateGolden {
-		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
-			t.Fatal(err)
-		}
-		if err := os.WriteFile(path, []byte(got), 0o644); err != nil {
-			t.Fatal(err)
-		}
-		return
-	}
-	want, err := os.ReadFile(path)
-	if err != nil {
-		t.Fatalf("missing golden %s (regenerate with -update): %v", name, err)
-	}
-	if string(want) != got {
-		t.Errorf("output drifted from golden %s\n--- want\n%s\n--- got\n%s", name, want, got)
-	}
-}

cmd/event/list.go

@@ -10,44 +10,31 @@ import (
 
 	"github.com/spf13/cobra"
 
-	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/cmdutil"
 	eventlib "github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
 	"github.com/larksuite/cli/internal/output"
 )
 
-func NewCmdList(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
+func NewCmdList(f *cmdutil.Factory) *cobra.Command {
 	var asJSON bool
-	var domain string
 	cmd := &cobra.Command{
 		Use:   "list",
 		Short: "List all available EventKeys",
-		Long:  "Show all registered EventKeys grouped by domain (first segment of the key). Use --domain to keep one domain only, --json for machine-readable output.",
+		Long:  "Show all registered EventKeys grouped by domain (first segment of the key). Use --json for machine-readable output.",
 		RunE: func(cmd *cobra.Command, args []string) error {
-			return runList(f, snap, domain, asJSON)
+			return runList(f, asJSON)
 		},
 	}
 	cmd.Flags().BoolVar(&asJSON, "json", false, "Emit the full EventKey list as JSON (for AI / scripts)")
-	cmd.Flags().StringVar(&domain, "domain", "", fmt.Sprintf(
-		"Only list EventKeys of this domain. Valid domains: %s",
-		strings.Join(snap.Domains(), ", "),
-	))
 	cmdutil.SetRisk(cmd, "read")
 	return cmd
 }
 
-func runList(f *cmdutil.Factory, snap *catalog.Snapshot, domain string, asJSON bool) error {
-	entries, err := entriesForDomain(snap, domain)
-	if err != nil {
-		return err
-	}
+func runList(f *cmdutil.Factory, asJSON bool) error {
+	all := eventlib.ListAll()
+
 	if asJSON {
-		return writeListJSON(f, entries)
-	}
-	all := make([]*eventlib.KeyDefinition, 0, len(entries))
-	for _, entry := range entries {
-		all = append(all, entry.Definition())
+		return writeListJSON(f, all)
 	}
 
 	if len(all) == 0 {
@@ -117,43 +104,18 @@ func runList(f *cmdutil.Factory, snap *catalog.Snapshot, domain string, asJSON b
 	return nil
 }
 
-// listRow is the JSON shape of one `event list --json` row. It is a named
-// type (not a function-local literal) so the render contract test can walk
-// its fields and reject accidental additions to the public output.
-type listRow struct {
-	*eventlib.KeyDefinition
-	ResolvedSchema json.RawMessage `json:"resolved_output_schema,omitempty"`
-}
-
-// entriesForDomain filters at the snapshot query layer: without a domain the
-// full catalog comes back untouched; with one, rows are only removed, never
-// reshaped. An unknown domain is rejected with the valid set spelled out.
-func entriesForDomain(snap *catalog.Snapshot, domain string) ([]*catalog.Entry, error) {
-	if domain == "" {
-		return snap.Entries(), nil
+func writeListJSON(f *cmdutil.Factory, all []*eventlib.KeyDefinition) error {
+	type row struct {
+		*eventlib.KeyDefinition
+		ResolvedSchema json.RawMessage `json:"resolved_output_schema,omitempty"`
 	}
-	var filtered []*catalog.Entry
-	for _, entry := range snap.Entries() {
-		if entry.Descriptor().Domain == domain {
-			filtered = append(filtered, entry)
-		}
-	}
-	if len(filtered) == 0 {
-		return nil, errs.NewValidationError(errs.SubtypeInvalidArgument,
-			"unknown domain: %s", domain).
-			WithParam("--domain").
-			WithHint("valid domains: %s", strings.Join(snap.Domains(), ", "))
-	}
-	return filtered, nil
-}
-
-func writeListJSON(f *cmdutil.Factory, entries []*catalog.Entry) error {
-	rows := make([]listRow, len(entries))
-	for i, entry := range entries {
-		rows[i] = listRow{
-			KeyDefinition:  entry.Definition(),
-			ResolvedSchema: entry.Output().SchemaJSON,
+	rows := make([]row, len(all))
+	for i, def := range all {
+		resolved, _, err := resolveSchemaJSON(def)
+		if err != nil {
+			return err
 		}
+		rows[i] = row{KeyDefinition: def, ResolvedSchema: resolved}
 	}
 	output.PrintJson(f.IOStreams.Out, rows)
 	return nil

cmd/event/list_domain_test.go

@@ -1,96 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"encoding/json"
-	"strings"
-	"testing"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/core"
-)
-
-// Filtering only removes rows: the vc selection must be exactly the catalog's
-// vc keys, and every remaining row keeps the unfiltered field set.
-func TestListDomain_FilterKeepsExactlyTheRequestedDomain(t *testing.T) {
-	snap := compileCatalog()
-
-	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-	if err := runList(f, snap, "vc", true); err != nil {
-		t.Fatal(err)
-	}
-	var rows []map[string]json.RawMessage
-	if err := json.Unmarshal(stdout.Bytes(), &rows); err != nil {
-		t.Fatal(err)
-	}
-
-	want := map[string]bool{}
-	for _, key := range snap.Keys() {
-		if strings.HasPrefix(key, "vc.") {
-			want[key] = true
-		}
-	}
-	if len(want) == 0 {
-		t.Fatal("the catalog has no vc keys; the filter test proves nothing")
-	}
-	got := map[string]bool{}
-	for _, row := range rows {
-		var key string
-		_ = json.Unmarshal(row["key"], &key)
-		got[key] = true
-		for _, field := range []string{"event_type", "schema", "resolved_output_schema"} {
-			if _, ok := row[field]; !ok {
-				t.Errorf("%s: filtering must not reshape rows; %q is missing", key, field)
-			}
-		}
-	}
-	if len(got) != len(want) {
-		t.Fatalf("filtered rows = %v, want the exact vc set %v", got, want)
-	}
-	for key := range want {
-		if !got[key] {
-			t.Errorf("vc key missing from the filtered list: %s", key)
-		}
-	}
-}
-
-func TestListDomain_TextFilter(t *testing.T) {
-	snap := compileCatalog()
-	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-	if err := runList(f, snap, "im", false); err != nil {
-		t.Fatal(err)
-	}
-	out := stdout.String()
-	if !strings.Contains(out, "im.message.receive_v1") {
-		t.Error("im keys must be listed")
-	}
-	for _, foreign := range []string{"vc.", "minutes.", "board.", "approval."} {
-		if strings.Contains(out, foreign) {
-			t.Errorf("foreign domain %q leaked into the filtered text output", foreign)
-		}
-	}
-}
-
-func TestListDomain_UnknownDomainIsRejectedWithTheValidSet(t *testing.T) {
-	snap := compileCatalog()
-	f, _, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-	err := runList(f, snap, "definitely-bogus", true)
-	if err == nil {
-		t.Fatal("an unknown domain must be rejected")
-	}
-	problem, ok := errs.ProblemOf(err)
-	if !ok || problem.Subtype != errs.SubtypeInvalidArgument {
-		t.Fatalf("want invalid_argument, got %v", err)
-	}
-	if !strings.Contains(err.Error(), "unknown domain: definitely-bogus") {
-		t.Errorf("error must name the rejected value, got %v", err)
-	}
-	for _, domain := range []string{"application", "approval", "board", "card", "im", "minutes", "task", "vc"} {
-		if !strings.Contains(problem.Hint, domain) {
-			t.Errorf("hint must list valid domain %q, got %q", domain, problem.Hint)
-		}
-	}
-}

cmd/event/list_test.go

@@ -10,18 +10,20 @@ import (
 
 	"github.com/larksuite/cli/internal/cmdutil"
 	"github.com/larksuite/cli/internal/core"
+	eventlib "github.com/larksuite/cli/internal/event"
+
+	_ "github.com/larksuite/cli/events"
 )
 
 func TestEventLookup_VCMeetingLifecycleKeys(t *testing.T) {
-	snap := compileCatalog()
 	for _, key := range []string{
 		"approval.instance.status_changed_v4",
 		"approval.task.status_changed_v4",
 		"vc.meeting.participant_meeting_started_v1",
 		"vc.meeting.participant_meeting_joined_v1",
 	} {
-		if _, ok := snap.Resolve(key); !ok {
-			t.Fatalf("snap.Resolve(%q) should succeed", key)
+		if _, ok := eventlib.Lookup(key); !ok {
+			t.Fatalf("event.Lookup(%q) should succeed", key)
 		}
 	}
 }
@@ -29,7 +31,7 @@ func TestEventLookup_VCMeetingLifecycleKeys(t *testing.T) {
 func TestRunList_TextOutput(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runList(f, compileCatalog(), "", false); err != nil {
+	if err := runList(f, false); err != nil {
 		t.Fatalf("runList: %v", err)
 	}
 
@@ -53,7 +55,7 @@ func TestRunList_TextOutput(t *testing.T) {
 func TestRunList_JSONOutput(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runList(f, compileCatalog(), "", true); err != nil {
+	if err := runList(f, true); err != nil {
 		t.Fatalf("runList json: %v", err)
 	}
 

cmd/event/preconditions_test.go

@@ -1,65 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"context"
-	"errors"
-	"testing"
-
-	"github.com/larksuite/cli/internal/core"
-	eventlib "github.com/larksuite/cli/internal/event"
-	appconsume "github.com/larksuite/cli/internal/event/application/consume"
-)
-
-func preconditionByName(list []appconsume.Precondition, name string) *appconsume.Precondition {
-	for i := range list {
-		if list[i].Name == name {
-			return &list[i]
-		}
-	}
-	return nil
-}
-
-// An unusable credential blocks the decision and carries the exact error a
-// real run would have returned, so both paths refuse for the same reason.
-func TestReadPreconditions_TokenErrorBlocksWithTheSameError(t *testing.T) {
-	tokenErr := errors.New("no tenant token available")
-	pf := &preflightCtx{
-		appID:    "cli_test",
-		identity: core.AsBot,
-		keyDef:   &eventlib.KeyDefinition{Key: "demo.thing.updated_v1"},
-	}
-	got := readPreconditions(context.Background(), pf, nil, tokenErr)
-
-	cred := preconditionByName(got, "credentials_available")
-	if cred == nil {
-		t.Fatal("credentials_available precondition missing")
-	}
-	if cred.Status != appconsume.PreconditionBlocked || !errors.Is(cred.BlockErr, tokenErr) {
-		t.Errorf("token failure must block with the original error, got %+v", cred)
-	}
-}
-
-// A scope ledger nobody could read is reported as unknown — never as ok.
-func TestReadPreconditions_UnreadableScopesAreUnknown(t *testing.T) {
-	pf := &preflightCtx{
-		appID:    "cli_test",
-		identity: core.AsBot,
-		keyDef: &eventlib.KeyDefinition{
-			Key:    "demo.thing.updated_v1",
-			Scopes: []string{"demo:read"},
-		},
-		appVer: nil, // no published version: the bot scope ledger is unreadable
-	}
-	got := readPreconditions(context.Background(), pf, nil, nil)
-
-	scopes := preconditionByName(got, "scopes_granted")
-	if scopes == nil {
-		t.Fatal("scopes_granted precondition missing")
-	}
-	if scopes.Status != appconsume.PreconditionUnknown {
-		t.Errorf("an unreadable ledger must report unknown, got %q", scopes.Status)
-	}
-}

cmd/event/preflight_test.go

@@ -108,7 +108,7 @@ func TestPreflightScopes_Bot_NoAppVer_SkipsCheck(t *testing.T) {
 		Key:    "im.message.text",
 		Scopes: []string{"im:message", "im:message.group_at_msg"},
 	}
-	_, err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, nil))
+	err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, nil))
 	if err != nil {
 		t.Fatalf("bot + nil appVer should skip, got: %v", err)
 	}
@@ -124,7 +124,7 @@ func TestPreflightScopes_Bot_AllGranted_Passes(t *testing.T) {
 		"im:message.group_at_msg",
 		"contact:user:readonly",
 	}}
-	_, err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, appVer))
+	err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, appVer))
 	if err != nil {
 		t.Fatalf("all scopes granted, unexpected error: %v", err)
 	}
@@ -136,7 +136,7 @@ func TestPreflightScopes_Bot_MissingBlocks(t *testing.T) {
 		Scopes: []string{"im:message", "im:message.group_at_msg"},
 	}
 	appVer := &appmeta.AppVersion{TenantScopes: []string{"im:message"}}
-	_, err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, appVer))
+	err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, appVer))
 	if err == nil {
 		t.Fatal("expected error for missing scope")
 	}
@@ -169,7 +169,7 @@ func TestPreflightScopes_Bot_MissingBlocks(t *testing.T) {
 
 func TestPreflightScopes_NoRequiredScopes_SkipsCheck(t *testing.T) {
 	def := &eventlib.KeyDefinition{Key: "x"}
-	if _, err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, nil)); err != nil {
+	if err := preflightScopes(nil, newPreflightCtx("cli_x", "feishu", core.AsBot, def, nil)); err != nil {
 		t.Fatalf("no required scopes means nothing to verify, got: %v", err)
 	}
 }

cmd/event/render/decision.go

@@ -1,96 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-// Package render turns consume decisions into user-facing output. It is the
-// only place a decision becomes JSON; the application layer never formats
-// anything itself.
-package render
-
-import (
-	"io"
-	"regexp"
-
-	appconsume "github.com/larksuite/cli/internal/event/application/consume"
-	"github.com/larksuite/cli/internal/output"
-)
-
-// sensitiveParamName matches parameter names whose values must never be
-// echoed back in a rendered decision. Names are matched, not values: a
-// credential-bearing parameter is identifiable by its declaration, and
-// guessing at value shapes would miss more than it catches.
-var sensitiveParamName = regexp.MustCompile(`(?i)(token|secret|password|credential|cookie)`)
-
-func redactParams(params map[string]string) map[string]string {
-	out := make(map[string]string, len(params))
-	for name, value := range params {
-		if sensitiveParamName.MatchString(name) {
-			out[name] = "[redacted]"
-			continue
-		}
-		out[name] = value
-	}
-	return out
-}
-
-// decisionPayload is the JSON shape under data.decision — snake_case, stable,
-// documented in the event skill. Field additions must be additive.
-type decisionPayload struct {
-	EventKey      string             `json:"event_key"`
-	Domain        string             `json:"domain"`
-	Identity      string             `json:"identity"`
-	Status        string             `json:"status"`
-	Params        map[string]string  `json:"params"`
-	Scope         string             `json:"scope"`
-	Preconditions []preconditionView `json:"preconditions"`
-	Preparation   *preparationView   `json:"preparation,omitempty"`
-	WouldRead     []string           `json:"would_read"`
-	WouldWrite    []string           `json:"would_write"`
-}
-
-type preconditionView struct {
-	Name   string `json:"name"`
-	Status string `json:"status"`
-	Detail string `json:"detail,omitempty"`
-}
-
-type preparationView struct {
-	Strategy  string `json:"strategy"`
-	Condition string `json:"condition"`
-	Action    string `json:"action"`
-}
-
-// WriteDecisionJSON emits the decision inside the standard success envelope
-// with the envelope's own top-level dry_run marker set.
-func WriteDecisionJSON(out, errOut io.Writer, identity string, v appconsume.DecisionView) error {
-	return output.WriteSuccessEnvelope(map[string]any{
-		"decision": toPayload(v),
-	}, output.SuccessEnvelopeOptions{
-		CommandPath: "event consume",
-		Identity:    identity,
-		DryRun:      true,
-		Out:         out,
-		ErrOut:      errOut,
-	})
-}
-
-func toPayload(v appconsume.DecisionView) decisionPayload {
-	p := decisionPayload{
-		EventKey:   v.EventKey,
-		Domain:     v.Domain,
-		Identity:   v.Identity,
-		Status:     v.Status,
-		Params:     redactParams(v.Params),
-		Scope:      v.Scope,
-		WouldRead:  v.WouldRead,
-		WouldWrite: v.WouldWrite,
-	}
-	p.Preconditions = make([]preconditionView, 0, len(v.Preconditions))
-	for _, pc := range v.Preconditions {
-		p.Preconditions = append(p.Preconditions, preconditionView(pc))
-	}
-	if v.Preparation != nil {
-		pv := preparationView(*v.Preparation)
-		p.Preparation = &pv
-	}
-	return p
-}

cmd/event/render/decision_test.go

@@ -1,114 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package render
-
-import (
-	"bytes"
-	"encoding/json"
-	"strings"
-	"testing"
-
-	appconsume "github.com/larksuite/cli/internal/event/application/consume"
-)
-
-func sampleView() appconsume.DecisionView {
-	return appconsume.DecisionView{
-		EventKey: "vc.note.generated_v1",
-		Domain:   "vc",
-		Identity: "user",
-		Status:   "ready",
-		Params:   map[string]string{"whiteboard_id": "wb-1", "access_token": "sk-SENSITIVE-VALUE"},
-		Scope:    "vc.note.generated_v1",
-		Preconditions: []appconsume.PreconditionView{
-			{Name: "console_event_published", Status: "ok"},
-			{Name: "scopes_granted", Status: "ok"},
-		},
-		Preparation: &appconsume.PreparationView{
-			Strategy: "legacy_preconsume", Condition: "first_consumer_for_scope", Action: "register_event_delivery",
-		},
-		WouldRead:  []string{"local_bus_probe", "app_metadata_preflight"},
-		WouldWrite: []string{"start_or_reuse_local_bus", "register_consumer", "run_preparation_when_first", "open_event_stream"},
-	}
-}
-
-// The JSON contract: dry_run is the envelope's own top-level marker (never a
-// data field), and the decision sits under data.decision with its documented
-// members.
-func TestWriteDecisionJSON_EnvelopeContract(t *testing.T) {
-	var out, errOut bytes.Buffer
-	if err := WriteDecisionJSON(&out, &errOut, "user", sampleView()); err != nil {
-		t.Fatal(err)
-	}
-
-	var envelope map[string]json.RawMessage
-	if err := json.Unmarshal(out.Bytes(), &envelope); err != nil {
-		t.Fatalf("stdout is not a JSON envelope: %v\n%s", err, out.String())
-	}
-	if string(envelope["ok"]) != "true" || string(envelope["dry_run"]) != "true" {
-		t.Errorf("envelope must carry top-level ok=true and dry_run=true, got %s", out.String())
-	}
-	if _, misplaced := envelope["decision"]; misplaced {
-		t.Error("decision must live under data, not at the envelope top level")
-	}
-
-	var data struct {
-		Decision struct {
-			EventKey    string            `json:"event_key"`
-			Domain      string            `json:"domain"`
-			Identity    string            `json:"identity"`
-			Status      string            `json:"status"`
-			Params      map[string]string `json:"params"`
-			Scope       string            `json:"scope"`
-			Preparation *struct {
-				Strategy  string `json:"strategy"`
-				Condition string `json:"condition"`
-				Action    string `json:"action"`
-			} `json:"preparation"`
-			WouldRead  []string `json:"would_read"`
-			WouldWrite []string `json:"would_write"`
-			DryRun     *bool    `json:"dry_run"`
-		} `json:"decision"`
-	}
-	if err := json.Unmarshal(envelope["data"], &data); err != nil {
-		t.Fatalf("data.decision does not match the documented shape: %v", err)
-	}
-	d := data.Decision
-	if d.EventKey != "vc.note.generated_v1" || d.Domain != "vc" || d.Identity != "user" || d.Status != "ready" {
-		t.Errorf("identity facts drifted: %+v", d)
-	}
-	if d.Preparation == nil || d.Preparation.Condition != "first_consumer_for_scope" {
-		t.Errorf("conditional preparation must be stated: %+v", d.Preparation)
-	}
-	if len(d.WouldRead) == 0 || len(d.WouldWrite) == 0 {
-		t.Error("would_read / would_write must be present")
-	}
-	if d.DryRun != nil {
-		t.Error("dry_run inside data.decision would duplicate the envelope marker")
-	}
-}
-
-// Sensitive parameter values never reach the rendered output. The control
-// assertion first proves the sentinel would be visible if leaked.
-func TestWriteDecision_RedactsSensitiveParams(t *testing.T) {
-	const sentinel = "sk-SENSITIVE-VALUE"
-	view := sampleView()
-	if !strings.Contains(view.Params["access_token"], sentinel) {
-		t.Fatal("control failed: the sentinel is not in the input, the test cannot prove redaction")
-	}
-
-	var jsonOut, jsonErr bytes.Buffer
-	if err := WriteDecisionJSON(&jsonOut, &jsonErr, "user", view); err != nil {
-		t.Fatal(err)
-	}
-	if strings.Contains(jsonOut.String(), sentinel) {
-		t.Errorf("JSON output leaks a sensitive param value: %s", jsonOut.String())
-	}
-	compact := strings.ReplaceAll(strings.ReplaceAll(jsonOut.String(), "\n", ""), " ", "")
-	if !strings.Contains(compact, `"access_token":"[redacted]"`) {
-		t.Errorf("sensitive param must render as redacted, got: %s", jsonOut.String())
-	}
-	if !strings.Contains(compact, `"whiteboard_id":"wb-1"`) {
-		t.Errorf("non-sensitive params must render verbatim, got: %s", jsonOut.String())
-	}
-}

cmd/event/render/redaction_guard_test.go

@@ -1,121 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package render
-
-import (
-	"strings"
-	"testing"
-
-	"github.com/larksuite/cli/events"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// This file is a guard, not a contract: it does not pin what the redaction
-// regex matches, it hunts for declared parameter names that smell like
-// credentials yet would render verbatim. The detector wordlist is therefore
-// deliberately wider than the production sensitiveParamName pattern — a hit
-// here means either the parameter should be renamed or the production
-// pattern must grow, decided by a human, never by loosening this list.
-
-// credentialWords are matched against whole '_'/'-'/'.'-separated segments of
-// a parameter name, so chat_key or tokenizer_mode cannot trip them. The bare
-// word "key" is intentionally absent (identifier names like whiteboard_id or
-// a hypothetical chat_key are not credentials); the api/key pairing is what
-// carries credential semantics and is detected as a pair below.
-var credentialWords = map[string]bool{
-	"token":       true,
-	"secret":      true,
-	"password":    true,
-	"credential":  true,
-	"credentials": true,
-	"cookie":      true,
-	"auth":        true,
-	"signature":   true,
-	"bearer":      true,
-	"apikey":      true,
-}
-
-// smellsLikeCredential reports whether a parameter name carries credential
-// semantics per the guard wordlist: any single segment in credentialWords,
-// or the adjacent segment pair api+key.
-func smellsLikeCredential(name string) bool {
-	segments := strings.FieldsFunc(strings.ToLower(name), func(r rune) bool {
-		return r == '_' || r == '-' || r == '.'
-	})
-	for i, seg := range segments {
-		if credentialWords[seg] {
-			return true
-		}
-		if seg == "api" && i+1 < len(segments) && segments[i+1] == "key" {
-			return true
-		}
-	}
-	return false
-}
-
-// unredactedCredentialParams returns the names that smell like credentials
-// but are NOT matched by the production redaction pattern — every such name
-// would render its value verbatim in a dry-run decision.
-func unredactedCredentialParams(names []string) []string {
-	var findings []string
-	for _, name := range names {
-		if smellsLikeCredential(name) && !sensitiveParamName.MatchString(name) {
-			findings = append(findings, name)
-		}
-	}
-	return findings
-}
-
-// The detector itself must bite before the live scan means anything: known
-// credential-shaped names that the production pattern misses must be caught,
-// and ordinary identifier names must pass.
-func TestRedactionGuardDetector_SelfCheck(t *testing.T) {
-	// Credential-shaped and covered by the production pattern: no finding.
-	for _, name := range []string{"access_token", "client_secret", "user_password", "session_cookie", "sso_credential"} {
-		if got := unredactedCredentialParams([]string{name}); len(got) != 0 {
-			t.Errorf("%q is redacted by the production pattern, the guard must not flag it, got %v", name, got)
-		}
-	}
-	// Credential-shaped but NOT covered by the production pattern today: the
-	// guard must flag these, otherwise it can never catch a real gap.
-	for _, name := range []string{"api_key", "auth_code", "request_signature", "bearer_value"} {
-		if got := unredactedCredentialParams([]string{name}); len(got) != 1 {
-			t.Errorf("%q smells like a credential and is not redacted; the guard must flag it, got %v", name, got)
-		}
-	}
-	// Ordinary identifiers, including the wide-false-positive shapes the
-	// wordlist is segment-matched to avoid: no finding.
-	for _, name := range []string{"whiteboard_id", "chat_key", "tokenizer_mode", "author", "meeting_no"} {
-		if got := unredactedCredentialParams([]string{name}); len(got) != 0 {
-			t.Errorf("%q is an ordinary identifier, the guard must not flag it, got %v", name, got)
-		}
-	}
-}
-
-// Every declared parameter of every compiled EventKey either carries no
-// credential semantics or is caught by the production redaction pattern.
-func TestRedactionGuard_CatalogParamsHaveNoUnredactedCredentials(t *testing.T) {
-	snap, err := catalog.Compile(events.All(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("compile catalog: %v", err)
-	}
-
-	var names []string
-	for _, entry := range snap.Entries() {
-		desc := entry.Descriptor()
-		for _, p := range desc.Params {
-			names = append(names, desc.Key+": "+p.Name)
-			if findings := unredactedCredentialParams([]string{p.Name}); len(findings) != 0 {
-				t.Errorf("EventKey %s declares param %q which smells like a credential but is not matched by the redaction pattern; rename the param or extend sensitiveParamName deliberately", desc.Key, p.Name)
-			}
-		}
-	}
-	// A scan that visited no parameters proves nothing.
-	if len(names) == 0 {
-		t.Fatal("the compiled catalog declares no parameters at all; the guard scanned nothing")
-	}
-}

cmd/event/render_contract_test.go

@@ -1,163 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"reflect"
-	"strings"
-	"testing"
-)
-
-// renderedDeclarationFields lists every JSON field the list/schema commands
-// are allowed to expose, each with the reason it belongs to the public
-// contract. Golden files pin today's bytes; this gate protects tomorrow: a
-// field added to the rendered structs (promoted through the embedded
-// definition or nested anywhere under it) must either appear here
-// deliberately or be tagged `json:"-"`. The set is flat — an entry admits its
-// rendered name at any nesting level, which is the same latitude
-// encoding/json gives a name.
-var renderedDeclarationFields = map[string]string{
-	"key":                     "stable identifier agents subscribe by",
-	"domain":                  "declared domain override; empty for every shipped key (filtering reads the derived descriptor value), so legacy output is byte-identical",
-	"display_name":            "human-readable name for pickers",
-	"description":             "what the event means (KeyDefinition) / what the parameter does (ParamDef)",
-	"event_type":              "upstream event type behind this key",
-	"subscription_type":       "which console ledger the precheck reads",
-	"params":                  "declared consume parameters",
-	"schema":                  "declared schema source (native/custom markers)",
-	"scopes":                  "OAuth scopes required to consume",
-	"auth_types":              "identities the key accepts",
-	"required_console_events": "console switches that must be enabled",
-	"buffer_size":             "delivery buffer size after normalization",
-	"workers":                 "worker count after normalization",
-	"single_consumer":         "whether a second consumer is rejected",
-	"resolved_output_schema":  "fully resolved JSON schema of stdout events",
-	"jq_root_path":            "schema command only: jq root for consuming stdout",
-
-	// Nested under params (ParamDef): everything an agent needs to pass the
-	// parameter correctly.
-	"name":             "parameter name as passed via --param",
-	"type":             "parameter value type (string/enum/multi/bool/int)",
-	"required":         "whether the parameter must be provided",
-	"default":          "value applied when the parameter is omitted",
-	"values":           "allowed values for enum/multi parameters",
-	"subscription_key": "whether the parameter is part of the subscription identity",
-
-	// Nested under params.values (ParamValue).
-	"value": "one allowed parameter value",
-	"desc":  "what choosing this value means",
-
-	// Nested under schema (SchemaDef / SchemaSpec): declaration markers only;
-	// the resolved schema is the sibling resolved_output_schema.
-	"native":          "marker for keys delivering the raw V2 envelope",
-	"custom":          "marker for keys delivering processed output",
-	"field_overrides": "per-field annotations overriding the reflected schema",
-	"raw":             "raw declared schema bytes; empty for reflected types",
-
-	// Nested under schema.field_overrides (schemas.FieldMeta). The type has
-	// no json tags, so encoding/json renders the Go field names — pinned
-	// as-is because retagging them would change the public bytes.
-	"Description": "override for the field's schema description",
-	"Enum":        "override for the field's allowed values",
-	"Kind":        "override rendered as the field's schema format",
-}
-
-// TestRenderContract_NoRuntimeFieldLeaksIntoJSON walks both rendered shapes,
-// following embedded struct promotion and recursing into every named type
-// reachable through the rendered fields, and fails on any exported member
-// that is neither allowlisted nor explicitly excluded from JSON.
-func TestRenderContract_NoRuntimeFieldLeaksIntoJSON(t *testing.T) {
-	emitted := map[string]bool{}
-	for _, typ := range []reflect.Type{
-		reflect.TypeFor[listRow](),
-		reflect.TypeFor[schemaPayload](),
-	} {
-		walkRenderedFields(t, typ, emitted, map[reflect.Type]bool{})
-	}
-
-	if len(emitted) == 0 {
-		t.Fatal("no rendered fields were visited; the gate scanned nothing")
-	}
-	// The embedded definition is where leaks would hide: prove promotion was
-	// actually followed by requiring fields that only exist on it. The nested
-	// sentinels prove each recursion path is really taken: subscription_key
-	// (slice-of-struct: ParamDef), desc (slice inside a nested struct:
-	// ParamValue), raw (pointer-to-struct: SchemaSpec), Enum (map value:
-	// FieldMeta, rendered under its Go name because the type is untagged).
-	for _, sentinel := range []string{
-		"key", "event_type", "resolved_output_schema",
-		"subscription_key", "desc", "raw", "Enum",
-	} {
-		if !emitted[sentinel] {
-			t.Fatalf("field %q was not visited; the walker no longer reaches every rendered shape", sentinel)
-		}
-	}
-	for name := range renderedDeclarationFields {
-		if !emitted[name] {
-			t.Errorf("allowlist entry %q is stale: no rendered struct emits it", name)
-		}
-	}
-}
-
-// walkRenderedFields records every JSON field name typ can render: embedded
-// structs promote into the parent object, and any struct reachable through a
-// field's type — behind pointers, slice/array elements, or map values — is
-// walked in turn, so a field added to a nested type like ParamDef cannot
-// escape the gate. visited breaks cycles; a type already recorded in this
-// walk contributes nothing new.
-func walkRenderedFields(t *testing.T, typ reflect.Type, emitted map[string]bool, visited map[reflect.Type]bool) {
-	t.Helper()
-	typ = nestedStructType(typ)
-	if typ == nil || visited[typ] {
-		return
-	}
-	visited[typ] = true
-	for i := 0; i < typ.NumField(); i++ {
-		field := typ.Field(i)
-		if !field.IsExported() {
-			continue
-		}
-		tag := field.Tag.Get("json")
-		if tag == "-" {
-			continue
-		}
-		if field.Anonymous && tag == "" {
-			if ft := nestedStructType(field.Type); ft != nil {
-				// Embedded struct without a tag: fields promote into the
-				// parent JSON object.
-				walkRenderedFields(t, ft, emitted, visited)
-				continue
-			}
-		}
-		name, _, _ := strings.Cut(tag, ",")
-		if name == "" {
-			// encoding/json renders an untagged exported field under its Go
-			// name (schemas.FieldMeta does this today); the rendered name is
-			// what the contract governs, so it is what must be declared.
-			name = field.Name
-		}
-		if _, ok := renderedDeclarationFields[name]; !ok {
-			t.Errorf("%s.%s renders JSON field %q that is not in the declared output contract; add it deliberately or exclude it with json:\"-\"", typ.Name(), field.Name, name)
-		}
-		emitted[name] = true
-		walkRenderedFields(t, field.Type, emitted, visited)
-	}
-}
-
-// nestedStructType unwraps pointers, slice/array elements, and map values
-// until it reaches the struct that would render as a JSON object; nil means
-// the type renders as a leaf (scalar, string, raw bytes) and holds no fields
-// to govern.
-func nestedStructType(typ reflect.Type) reflect.Type {
-	for {
-		switch typ.Kind() {
-		case reflect.Pointer, reflect.Slice, reflect.Array, reflect.Map:
-			typ = typ.Elem()
-		case reflect.Struct:
-			return typ
-		default:
-			return nil
-		}
-	}
-}

cmd/event/schema.go

@@ -11,13 +11,75 @@ import (
 
 	"github.com/spf13/cobra"
 
+	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/cmdutil"
 	eventlib "github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
+	"github.com/larksuite/cli/internal/event/schemas"
 	"github.com/larksuite/cli/internal/output"
 )
 
-func NewCmdSchema(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
+// resolveSchemaJSON returns the final JSON Schema for an EventKey (reflected base, V2-wrapped for Native, overlay applied); orphans lists unresolved FieldOverrides pointers.
+func resolveSchemaJSON(def *eventlib.KeyDefinition) (json.RawMessage, []string, error) {
+	spec, isNative := pickSpec(def.Schema)
+	if spec == nil {
+		return nil, nil, nil
+	}
+
+	base, err := renderSpec(spec)
+	if err != nil {
+		return nil, nil, err
+	}
+	if base == nil {
+		return nil, nil, nil
+	}
+
+	if isNative {
+		base = schemas.WrapV2Envelope(base)
+	}
+
+	if len(def.Schema.FieldOverrides) > 0 {
+		var parsed map[string]interface{}
+		if err := json.Unmarshal(base, &parsed); err != nil {
+			return nil, nil, errs.NewInternalError(errs.SubtypeUnknown,
+				"parse base schema for field overrides: %s", err).WithCause(err)
+		}
+		orphans := schemas.ApplyFieldOverrides(parsed, def.Schema.FieldOverrides)
+		out, err := json.Marshal(parsed)
+		if err != nil {
+			return nil, nil, errs.NewInternalError(errs.SubtypeUnknown,
+				"serialize schema with field overrides: %s", err).WithCause(err)
+		}
+		return out, orphans, nil
+	}
+
+	return base, nil, nil
+}
+
+// pickSpec returns the non-nil spec and whether it is Native (requires V2 envelope wrap).
+func pickSpec(s eventlib.SchemaDef) (*eventlib.SchemaSpec, bool) {
+	if s.Native != nil {
+		return s.Native, true
+	}
+	if s.Custom != nil {
+		return s.Custom, false
+	}
+	return nil, false
+}
+
+// renderSpec produces a JSON Schema from Type (reflected) or Raw (copied).
+func renderSpec(s *eventlib.SchemaSpec) (json.RawMessage, error) {
+	if s.Type != nil {
+		return schemas.FromType(s.Type), nil
+	}
+	if len(s.Raw) > 0 {
+		buf := make(json.RawMessage, len(s.Raw))
+		copy(buf, s.Raw)
+		return buf, nil
+	}
+	return nil, errs.NewInternalError(errs.SubtypeUnknown, "schemaSpec has neither Type nor Raw")
+}
+
+func NewCmdSchema(f *cmdutil.Factory) *cobra.Command {
 	var asJSON bool
 	cmd := &cobra.Command{
 		Use:   "schema <EventKey>",
@@ -25,7 +87,7 @@ func NewCmdSchema(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
 		Long:  "Display detailed information about an EventKey including type, events, parameters, and response schema. Use --json for machine-readable output.",
 		Args:  cobra.ExactArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
-			return runSchema(f, snap, args[0], asJSON)
+			return runSchema(f, args[0], asJSON)
 		},
 	}
 	cmd.Flags().BoolVar(&asJSON, "json", false, "Emit the EventKey definition + resolved schema as JSON (for AI / scripts)")
@@ -33,15 +95,14 @@ func NewCmdSchema(f *cmdutil.Factory, snap *catalog.Snapshot) *cobra.Command {
 	return cmd
 }
 
-func runSchema(f *cmdutil.Factory, snap *catalog.Snapshot, key string, asJSON bool) error {
-	entry, ok := snap.Resolve(key)
+func runSchema(f *cmdutil.Factory, key string, asJSON bool) error {
+	def, ok := eventlib.Lookup(key)
 	if !ok {
-		return unknownEventKeyErr(snap, key)
+		return unknownEventKeyErr(key)
 	}
-	def := entry.Definition()
 
 	if asJSON {
-		return writeSchemaJSON(f, entry)
+		return writeSchemaJSON(f, def)
 	}
 
 	out := f.IOStreams.Out
@@ -109,7 +170,10 @@ func runSchema(f *cmdutil.Factory, snap *catalog.Snapshot, key string, asJSON bo
 		}
 	}
 
-	resolved := entry.Output().SchemaJSON
+	resolved, _, err := resolveSchemaJSON(def)
+	if err != nil {
+		return err
+	}
 	if resolved != nil {
 		fmt.Fprintf(out, "\nOutput Schema:\n")
 		printIndentedJSON(out, resolved)
@@ -138,22 +202,30 @@ func printIndentedJSON(out io.Writer, raw json.RawMessage) {
 	fmt.Fprintf(out, "  %s\n", string(formatted))
 }
 
-// schemaPayload is the JSON shape of `event schema --json`. It is a named
-// type (not a function-local literal) so the render contract test can walk
-// its fields and reject accidental additions to the public output.
-type schemaPayload struct {
-	*eventlib.KeyDefinition
-	ResolvedSchema json.RawMessage `json:"resolved_output_schema,omitempty"`
-	JQRootPath     string          `json:"jq_root_path,omitempty"`
-}
-
 // writeSchemaJSON emits the EventKey definition plus resolved schema; jq_root_path tells callers whether fields live at `.` or `.event`.
-func writeSchemaJSON(f *cmdutil.Factory, entry *catalog.Entry) error {
-	contract := entry.Output()
-	output.PrintJson(f.IOStreams.Out, schemaPayload{
-		KeyDefinition:  entry.Definition(),
-		ResolvedSchema: contract.SchemaJSON,
-		JQRootPath:     contract.JQRootPath,
+func writeSchemaJSON(f *cmdutil.Factory, def *eventlib.KeyDefinition) error {
+	type payload struct {
+		*eventlib.KeyDefinition
+		ResolvedSchema json.RawMessage `json:"resolved_output_schema,omitempty"`
+		JQRootPath     string          `json:"jq_root_path,omitempty"`
+	}
+	resolved, _, err := resolveSchemaJSON(def)
+	if err != nil {
+		return err
+	}
+	var jqRootPath string
+	if resolved != nil {
+		// Native → V2 envelope ⇒ `.event.xxx`; Custom → flat ⇒ `.`.
+		_, isNative := pickSpec(def.Schema)
+		jqRootPath = "."
+		if isNative {
+			jqRootPath = ".event"
+		}
+	}
+	output.PrintJson(f.IOStreams.Out, payload{
+		KeyDefinition:  def,
+		ResolvedSchema: resolved,
+		JQRootPath:     jqRootPath,
 	})
 	return nil
 }

cmd/event/schema_test.go

@@ -10,26 +10,14 @@ import (
 	"strings"
 	"testing"
 
+	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/cmdutil"
 	"github.com/larksuite/cli/internal/core"
 	eventlib "github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
 	"github.com/larksuite/cli/internal/event/schemas"
-)
 
-// compileTestSnapshot compiles synthetic declarations into a snapshot using
-// the same strategy set the production wiring provides.
-func compileTestSnapshot(t *testing.T, defs ...eventlib.KeyDefinition) *catalog.Snapshot {
-	t.Helper()
-	snap, err := catalog.Compile(defs, catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("compile test catalog: %v", err)
-	}
-	return snap
-}
+	_ "github.com/larksuite/cli/events"
+)
 
 type approvalSchemaJSONPayload struct {
 	JQRootPath           string                           `json:"jq_root_path"`
@@ -57,7 +45,7 @@ type approvalSchemaJSONProperty struct {
 func TestRunSchema_ProcessedKey_Text(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runSchema(f, compileCatalog(), "im.message.receive_v1", false); err != nil {
+	if err := runSchema(f, "im.message.receive_v1", false); err != nil {
 		t.Fatalf("runSchema: %v", err)
 	}
 
@@ -77,7 +65,7 @@ func TestRunSchema_ProcessedKey_Text(t *testing.T) {
 func TestRunSchema_NativeKey_WrapsEnvelope(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runSchema(f, compileCatalog(), "im.message.message_read_v1", false); err != nil {
+	if err := runSchema(f, "im.message.message_read_v1", false); err != nil {
 		t.Fatalf("runSchema: %v", err)
 	}
 
@@ -97,7 +85,7 @@ func TestRunSchema_NativeKey_WrapsEnvelope(t *testing.T) {
 func TestRunSchema_UnknownKey_SuggestsAlternatives(t *testing.T) {
 	f, _, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	err := runSchema(f, compileCatalog(), "im.message.recieve_v1", false)
+	err := runSchema(f, "im.message.recieve_v1", false)
 	if err == nil {
 		t.Fatal("expected error for unknown key")
 	}
@@ -113,7 +101,7 @@ func TestRunSchema_UnknownKey_SuggestsAlternatives(t *testing.T) {
 func TestRunSchema_JSONOutput(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runSchema(f, compileCatalog(), "im.message.receive_v1", true); err != nil {
+	if err := runSchema(f, "im.message.receive_v1", true); err != nil {
 		t.Fatalf("runSchema json: %v", err)
 	}
 
@@ -134,7 +122,7 @@ func TestRunSchema_JSONOutput(t *testing.T) {
 func TestRunSchema_ReceiveMessageAgentFieldsJSON(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runSchema(f, compileCatalog(), "im.message.receive_v1", true); err != nil {
+	if err := runSchema(f, "im.message.receive_v1", true); err != nil {
 		t.Fatalf("runSchema json: %v", err)
 	}
 
@@ -168,7 +156,7 @@ func TestRunSchema_ReceiveMessageAgentFieldsJSON(t *testing.T) {
 func TestRunSchema_TaskUpdateUserAccessJSON(t *testing.T) {
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-	if err := runSchema(f, compileCatalog(), "task.task.update_user_access_v2", true); err != nil {
+	if err := runSchema(f, "task.task.update_user_access_v2", true); err != nil {
 		t.Fatalf("runSchema json: %v", err)
 	}
 
@@ -207,7 +195,7 @@ func TestRunSchema_ApprovalStatusChangedJSON(t *testing.T) {
 			t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 			f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-			if err := runSchema(f, compileCatalog(), tc.key, true); err != nil {
+			if err := runSchema(f, tc.key, true); err != nil {
 				t.Fatalf("runSchema json: %v", err)
 			}
 
@@ -255,7 +243,7 @@ func TestRunSchema_JSONOutput_VCMeetingLifecycleKeys(t *testing.T) {
 		t.Run(key, func(t *testing.T) {
 			f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
 
-			if err := runSchema(f, compileCatalog(), key, true); err != nil {
+			if err := runSchema(f, key, true); err != nil {
 				t.Fatalf("runSchema json: %v", err)
 			}
 
@@ -288,8 +276,9 @@ func TestRunSchema_JSONOutput_VCMeetingLifecycleKeys(t *testing.T) {
 
 func TestSchema_RendersSubscriptionKeyMarker(t *testing.T) {
 	const syntheticKey = "test.evt_sub"
+	t.Cleanup(func() { eventlib.UnregisterKeyForTest(syntheticKey) })
 
-	snap := compileTestSnapshot(t, eventlib.KeyDefinition{
+	eventlib.RegisterKey(eventlib.KeyDefinition{
 		Key:       syntheticKey,
 		EventType: syntheticKey,
 		Params: []eventlib.ParamDef{
@@ -300,7 +289,7 @@ func TestSchema_RendersSubscriptionKeyMarker(t *testing.T) {
 	})
 
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-	if err := runSchema(f, snap, syntheticKey, false); err != nil {
+	if err := runSchema(f, syntheticKey, false); err != nil {
 		t.Fatalf("runSchema: %v", err)
 	}
 
@@ -336,8 +325,9 @@ func TestSchema_RendersSubscriptionKeyMarker(t *testing.T) {
 
 func TestSchema_JSON_IncludesSubscriptionKey(t *testing.T) {
 	const syntheticKey = "test.evt_json"
+	t.Cleanup(func() { eventlib.UnregisterKeyForTest(syntheticKey) })
 
-	snap := compileTestSnapshot(t, eventlib.KeyDefinition{
+	eventlib.RegisterKey(eventlib.KeyDefinition{
 		Key:       syntheticKey,
 		EventType: syntheticKey,
 		Params:    []eventlib.ParamDef{{Name: "mailbox", SubscriptionKey: true}},
@@ -345,7 +335,7 @@ func TestSchema_JSON_IncludesSubscriptionKey(t *testing.T) {
 	})
 
 	f, stdout, _, _ := cmdutil.TestFactory(t, &core.CliConfig{AppID: "test"})
-	if err := runSchema(f, snap, syntheticKey, true); err != nil {
+	if err := runSchema(f, syntheticKey, true); err != nil {
 		t.Fatalf("runSchema json: %v", err)
 	}
 
@@ -359,13 +349,12 @@ func TestSchema_JSON_IncludesSubscriptionKey(t *testing.T) {
 
 func TestResolveSchemaJSON_CustomWithOverlay(t *testing.T) {
 	const syntheticKey = "t.custom.overlay"
+	t.Cleanup(func() { eventlib.UnregisterKeyForTest(syntheticKey) })
 
 	type out struct {
 		SenderID string `json:"sender_id"`
 	}
-	// A compile that succeeds proves the overlay left no orphan pointers; the
-	// entry's output contract carries the resolved schema.
-	snap := compileTestSnapshot(t, eventlib.KeyDefinition{
+	eventlib.RegisterKey(eventlib.KeyDefinition{
 		Key:       syntheticKey,
 		EventType: syntheticKey,
 		Schema: eventlib.SchemaDef{
@@ -378,12 +367,13 @@ func TestResolveSchemaJSON_CustomWithOverlay(t *testing.T) {
 			return nil, nil
 		},
 	})
-	entry, ok := snap.Resolve(syntheticKey)
-	if !ok {
-		t.Fatalf("snap.Resolve(%q) should succeed", syntheticKey)
+	def, _ := eventlib.Lookup(syntheticKey)
+	resolved, orphans, err := resolveSchemaJSON(def)
+	if err != nil || len(orphans) != 0 {
+		t.Fatalf("resolve: err=%v orphans=%v", err, orphans)
 	}
 	var parsed map[string]interface{}
-	if err := json.Unmarshal(entry.Output().SchemaJSON, &parsed); err != nil {
+	if err := json.Unmarshal(resolved, &parsed); err != nil {
 		t.Fatal(err)
 	}
 	got := parsed["properties"].(map[string]interface{})["sender_id"].(map[string]interface{})["format"]
@@ -392,35 +382,37 @@ func TestResolveSchemaJSON_CustomWithOverlay(t *testing.T) {
 	}
 }
 
-func TestCompile_EmptySpecIsRejected(t *testing.T) {
-	_, err := catalog.Compile([]eventlib.KeyDefinition{{
-		Key:       "synthetic.empty.spec",
-		EventType: "synthetic.empty.spec",
-		Schema:    eventlib.SchemaDef{Native: &eventlib.SchemaSpec{}},
-	}}, catalog.StrategyRefs{catalog.StrategyNone})
+func TestRenderSpec_EmptySpecIsTypedInternalError(t *testing.T) {
+	_, err := renderSpec(&eventlib.SchemaSpec{})
 	if err == nil {
 		t.Fatal("expected error for spec with neither Type nor Raw")
 	}
-	if !strings.Contains(err.Error(), "exactly one of Type or Raw") {
-		t.Errorf("error should reject the empty spec, got: %v", err)
+	p, ok := errs.ProblemOf(err)
+	if !ok {
+		t.Fatalf("expected typed errs error, got %T: %v", err, err)
+	}
+	if p.Category != errs.CategoryInternal {
+		t.Errorf("category = %s, want %s", p.Category, errs.CategoryInternal)
 	}
 }
 
-func TestCompile_InvalidBaseWithOverridesIsRejected(t *testing.T) {
-	_, err := catalog.Compile([]eventlib.KeyDefinition{{
-		Key:       "synthetic.invalid.base",
-		EventType: "synthetic.invalid.base",
+func TestResolveSchemaJSON_InvalidBaseWithOverridesIsTypedInternalError(t *testing.T) {
+	def := &eventlib.KeyDefinition{
+		Key: "synthetic.invalid.base",
 		Schema: eventlib.SchemaDef{
 			Custom:         &eventlib.SchemaSpec{Raw: json.RawMessage("{not json")},
 			FieldOverrides: map[string]schemas.FieldMeta{"x": {}},
 		},
-	}}, catalog.StrategyRefs{catalog.StrategyNone})
+	}
+	_, _, err := resolveSchemaJSON(def)
 	if err == nil {
 		t.Fatal("expected error for unparsable base schema")
 	}
-	// Garbage raw bytes are rejected by the spec check itself, before the
-	// overlay machinery would even try to parse them.
-	if !strings.Contains(err.Error(), "is not a JSON object") {
-		t.Errorf("error should reject the unparsable base schema, got: %v", err)
+	p, ok := errs.ProblemOf(err)
+	if !ok {
+		t.Fatalf("expected typed errs error, got %T: %v", err, err)
+	}
+	if p.Category != errs.CategoryInternal {
+		t.Errorf("category = %s, want %s", p.Category, errs.CategoryInternal)
 	}
 }

cmd/event/service_adapters.go

@@ -1,85 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"context"
-
-	eventlib "github.com/larksuite/cli/internal/event"
-	appconsume "github.com/larksuite/cli/internal/event/application/consume"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// consumeStrategies is the executable strategy set for this binary. The same
-// registry is handed to catalog compilation, so a reference the compiler
-// accepted is guaranteed to resolve here.
-var consumeStrategies = appconsume.DefaultRegistry()
-
-type identityResolverFunc func(ctx context.Context, entry *catalog.Entry) (string, error)
-
-func (f identityResolverFunc) Resolve(ctx context.Context, entry *catalog.Entry) (string, error) {
-	return f(ctx, entry)
-}
-
-type preflightReaderFunc func(ctx context.Context, entry *catalog.Entry, identity string) ([]appconsume.Precondition, error)
-
-func (f preflightReaderFunc) Read(ctx context.Context, entry *catalog.Entry, identity string) ([]appconsume.Precondition, error) {
-	return f(ctx, entry, identity)
-}
-
-type streamRunnerFunc func(ctx context.Context, prepare appconsume.PrepareFunc) error
-
-func (f streamRunnerFunc) Run(ctx context.Context, prepare appconsume.PrepareFunc) error {
-	return f(ctx, prepare)
-}
-
-// readPreconditions classifies the existing read-only preflight checks into
-// named preconditions. Weak dependencies that could not answer stay visible
-// as "unknown" instead of silently passing; a failed check carries the exact
-// error a real run returns, so refusal is identical on both paths.
-func readPreconditions(ctx context.Context, pf *preflightCtx, appVerErr, tokenErr error) []appconsume.Precondition {
-	credentials := appconsume.Precondition{Name: "credentials_available", Status: appconsume.PreconditionOK}
-	if tokenErr != nil {
-		credentials.Status = appconsume.PreconditionBlocked
-		credentials.Detail = tokenErr.Error()
-		credentials.BlockErr = tokenErr
-	}
-
-	console := appconsume.Precondition{Name: "console_event_published", Status: appconsume.PreconditionOK}
-	switch {
-	case len(pf.keyDef.RequiredConsoleEvents) == 0:
-		// nothing to verify
-	case pf.keyDef.SubscriptionType == eventlib.SubTypeCallback && pf.subscribedCallbacks == nil,
-		pf.keyDef.SubscriptionType != eventlib.SubTypeCallback && pf.appVer == nil:
-		console.Status = appconsume.PreconditionUnknown
-		if appVerErr != nil {
-			console.Detail = describeAppMetaErr(appVerErr)
-		} else {
-			console.Detail = "console ledger unavailable"
-		}
-	default:
-		if err := preflightEventTypes(pf); err != nil {
-			console.Status = appconsume.PreconditionBlocked
-			console.Detail = err.Error()
-			console.BlockErr = err
-		}
-	}
-
-	scopes := appconsume.Precondition{Name: "scopes_granted", Status: appconsume.PreconditionOK}
-	checked, err := preflightScopes(ctx, pf)
-	switch {
-	case err != nil:
-		scopes.Status = appconsume.PreconditionBlocked
-		scopes.Detail = err.Error()
-		scopes.BlockErr = err
-	case !checked:
-		// The scope ledger could not be read (no published version for bots,
-		// no resolvable token for users). Saying "ok" here would dress up
-		// "nobody looked" as "it was verified".
-		scopes.Status = appconsume.PreconditionUnknown
-		scopes.Detail = "granted scopes could not be read for this identity"
-	}
-
-	return []appconsume.Precondition{credentials, console, scopes}
-}

cmd/event/status.go

@@ -14,10 +14,10 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busctl"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busdiscover"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/protocol"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/transport"
+	"github.com/larksuite/cli/internal/event/busctl"
+	"github.com/larksuite/cli/internal/event/busdiscover"
+	"github.com/larksuite/cli/internal/event/protocol"
+	"github.com/larksuite/cli/internal/event/transport"
 	"github.com/larksuite/cli/internal/output"
 )
 

cmd/event/status_orphan_test.go

@@ -11,8 +11,8 @@ import (
 	"testing"
 	"time"
 
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busdiscover"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/protocol"
+	"github.com/larksuite/cli/internal/event/busdiscover"
+	"github.com/larksuite/cli/internal/event/protocol"
 )
 
 type fakeScanner struct {

cmd/event/stop.go

@@ -13,9 +13,9 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/larksuite/cli/internal/cmdutil"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busctl"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busdiscover"
-	"github.com/larksuite/cli/internal/event/adapter/localbus/transport"
+	"github.com/larksuite/cli/internal/event/busctl"
+	"github.com/larksuite/cli/internal/event/busdiscover"
+	"github.com/larksuite/cli/internal/event/transport"
 	"github.com/larksuite/cli/internal/output"
 )
 

cmd/event/stop_discover_test.go

@@ -9,7 +9,7 @@ import (
 	"sort"
 	"testing"
 
-	"github.com/larksuite/cli/internal/event/adapter/localbus/busdiscover"
+	"github.com/larksuite/cli/internal/event/busdiscover"
 )
 
 func TestDiscoverAppIDs_OnlyLiveLockHolders(t *testing.T) {

cmd/event/stop_integration_test.go

@@ -13,7 +13,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/larksuite/cli/internal/event/adapter/localbus/protocol"
+	"github.com/larksuite/cli/internal/event/protocol"
 )
 
 type mockTransport struct {

cmd/event/suggestions.go

@@ -9,14 +9,14 @@ import (
 	"strings"
 
 	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/internal/event/catalog"
+	eventlib "github.com/larksuite/cli/internal/event"
 	"github.com/larksuite/cli/internal/suggest"
 )
 
 const maxSuggestions = 3
 
 // suggestEventKeys returns up to maxSuggestions keys resembling input (substring match beats edit distance).
-func suggestEventKeys(snap *catalog.Snapshot, input string) []string {
+func suggestEventKeys(input string) []string {
 	type match struct {
 		key  string
 		dist int
@@ -24,13 +24,13 @@ func suggestEventKeys(snap *catalog.Snapshot, input string) []string {
 	var hits []match
 	threshold := max(2, len(input)/5)
 
-	for _, key := range snap.Keys() {
-		if strings.Contains(key, input) {
-			hits = append(hits, match{key, 0})
+	for _, def := range eventlib.ListAll() {
+		if strings.Contains(def.Key, input) {
+			hits = append(hits, match{def.Key, 0})
 			continue
 		}
-		if d := suggest.Levenshtein(input, key); d <= threshold {
-			hits = append(hits, match{key, d})
+		if d := suggest.Levenshtein(input, def.Key); d <= threshold {
+			hits = append(hits, match{def.Key, d})
 		}
 	}
 	sort.Slice(hits, func(i, j int) bool { return hits[i].dist < hits[j].dist })
@@ -59,9 +59,9 @@ func formatSuggestions(keys []string) string {
 }
 
 // unknownEventKeyErr builds the shared "unknown EventKey" error with a suggestion tail when available.
-func unknownEventKeyErr(snap *catalog.Snapshot, key string) error {
+func unknownEventKeyErr(key string) error {
 	msg := fmt.Sprintf("unknown EventKey: %s", key)
-	if guesses := suggestEventKeys(snap, key); len(guesses) > 0 {
+	if guesses := suggestEventKeys(key); len(guesses) > 0 {
 		msg += " — did you mean " + formatSuggestions(guesses) + "?"
 	}
 	return errs.NewValidationError(errs.SubtypeInvalidArgument, "%s", msg).

cmd/event/suggestions_test.go

@@ -6,10 +6,11 @@ package event
 import (
 	"strings"
 	"testing"
+
+	_ "github.com/larksuite/cli/events"
 )
 
 func TestSuggestEventKeys(t *testing.T) {
-	snap := compileCatalog()
 	cases := []struct {
 		name              string
 		input             string
@@ -40,7 +41,7 @@ func TestSuggestEventKeys(t *testing.T) {
 	}
 	for _, tc := range cases {
 		t.Run(tc.name, func(t *testing.T) {
-			got := suggestEventKeys(snap, tc.input)
+			got := suggestEventKeys(tc.input)
 			if tc.wantEmpty {
 				if len(got) != 0 {
 					t.Errorf("expected empty slice, got %v", got)
@@ -97,7 +98,7 @@ func TestFormatSuggestions(t *testing.T) {
 }
 
 func TestUnknownEventKeyErr_IncludesSuggestion(t *testing.T) {
-	err := unknownEventKeyErr(compileCatalog(), "im.message.recieve_v1")
+	err := unknownEventKeyErr("im.message.recieve_v1")
 	if err == nil {
 		t.Fatal("expected error")
 	}
@@ -114,7 +115,7 @@ func TestUnknownEventKeyErr_IncludesSuggestion(t *testing.T) {
 }
 
 func TestUnknownEventKeyErr_NoSuggestion(t *testing.T) {
-	err := unknownEventKeyErr(compileCatalog(), "xyzzy_no_such_event_key_at_all")
+	err := unknownEventKeyErr("xyzzy_no_such_event_key_at_all")
 	if err == nil {
 		t.Fatal("expected error")
 	}

cmd/event/testdata/golden/list_text.golden

@@ -1,42 +0,0 @@
-KEY                                             AUTH      PARAMS  DESCRIPTION
-
-── application ──
-application.bot.menu_v6                         bot       0       Triggered when a user clicks a custom bot menu item whose action is configured as a push event.
-
-── approval ──
-approval.instance.status_changed_v4             user      1       Triggered after an approval instance status becomes visible to the requester or approval participants
-approval.task.status_changed_v4                 user      1       Triggered after an approval task status becomes visible to the requester or task approver
-
-── board ──
-board.whiteboard.updated_v1                     user|bot  1       Pushed when the whiteboard content is updated.
-
-── card ──
-card.action.trigger                             bot       0       Triggered when a user interacts with an interactive card (button click, form submit, dropdown select, etc.). Output includes: token (valid 30 min, max 2 updates), action details (tag, value, name, form_value), and card_content (original card in userDSL text format, auto-fetched at consume time). To update the card: parse card_content to understand the current state, construct the new card JSON, then call `lark-cli api POST /open-apis/interactive/v1/card/update` with the token (see lark-im-card-action-reply.md).
-
-── im ──
-im.chat.disbanded_v1                            bot       0       Triggered after a chat is disbanded
-im.chat.member.bot.added_v1                     bot       0       Triggered when the bot is added to a chat
-im.chat.member.bot.deleted_v1                   bot       0       Triggered after the bot is removed from a chat
-im.chat.member.user.added_v1                    bot       0       Triggered when a new user joins a chat (including topic chats)
-im.chat.member.user.deleted_v1                  bot       0       Triggered when a user leaves or is removed from a chat
-im.chat.member.user.withdrawn_v1                bot       0       Triggered after a pending user invite is withdrawn
-im.chat.updated_v1                              bot       0       Triggered after chat settings (owner, avatar, name, permissions, etc.) are updated
-im.message.message_read_v1                      bot       0       Triggered after a user reads a P2P message sent by the bot
-im.message.reaction.created_v1                  bot       0       Triggered when a reaction is added to a message
-im.message.reaction.deleted_v1                  bot       0       Triggered when a reaction is removed from a message
-im.message.receive_v1                           bot       0       Receive IM messages
-
-── minutes ──
-minutes.minute.generated_v1                     user      0       Triggered when a minute has been generated
-
-── task ──
-task.task.update_user_access_v2                 user|bot  0       Triggered when tasks visible to the current user or app are created, deleted, or updated
-
-── vc ──
-vc.meeting.participant_meeting_ended_v1         user      0       Triggered when a meeting the current user participates in has ended
-vc.meeting.participant_meeting_joined_v1        user      0       Triggered when the current user joins a meeting
-vc.meeting.participant_meeting_started_v1       user      0       Triggered when a meeting the current user participates in has started
-vc.note.generated_v1                            user      0       Triggered when a note has been generated
-vc.recording.recording_ended_v1                 user      0       Triggered when a recording_bean recording ends and uploads successfully; only generated when connected to Feishu software.
-vc.recording.recording_started_v1               user      0       Triggered when a recording_bean recording starts; only generated when connected to Feishu software.
-vc.recording.recording_transcript_generated_v1  user      0       Triggered when recording_bean transcript items are generated; only generated when connected to Feishu software.

cmd/event/testdata/golden/schema_board_whiteboard_json.golden

@@ -1,127 +0,0 @@
-{
-  "key": "board.whiteboard.updated_v1",
-  "display_name": "Whiteboard updated",
-  "description": "Pushed when the whiteboard content is updated.",
-  "event_type": "board.whiteboard.updated_v1",
-  "subscription_type": "event",
-  "params": [
-    {
-      "name": "whiteboard_id",
-      "type": "string",
-      "required": true,
-      "description": "Whiteboard id to subscribe; subscription is per-whiteboard.",
-      "subscription_key": true
-    }
-  ],
-  "schema": {
-    "native": {},
-    "field_overrides": {
-      "/event/operator_ids/*/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/operator_ids/*/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/operator_ids/*/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      },
-      "/event/whiteboard_id": {
-        "Description": "whiteboard id to subscribe",
-        "Enum": null,
-        "Kind": "whiteboard_id"
-      }
-    }
-  },
-  "scopes": [
-    "board:whiteboard:node:read"
-  ],
-  "auth_types": [
-    "user",
-    "bot"
-  ],
-  "required_console_events": [
-    "board.whiteboard.updated_v1"
-  ],
-  "buffer_size": 100,
-  "workers": 1,
-  "resolved_output_schema": {
-    "description": "飞书事件",
-    "properties": {
-      "event": {
-        "properties": {
-          "operator_ids": {
-            "items": {
-              "properties": {
-                "open_id": {
-                  "format": "open_id",
-                  "type": "string"
-                },
-                "union_id": {
-                  "format": "union_id",
-                  "type": "string"
-                },
-                "user_id": {
-                  "format": "user_id",
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "whiteboard_id": {
-            "description": "whiteboard id to subscribe",
-            "format": "whiteboard_id",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "header": {
-        "description": "事件头，所有事件结构一致",
-        "properties": {
-          "app_id": {
-            "description": "接收事件的应用 ID",
-            "type": "string"
-          },
-          "create_time": {
-            "description": "事件创建时间，毫秒时间戳字符串",
-            "type": "string"
-          },
-          "event_id": {
-            "description": "事件唯一 ID",
-            "type": "string"
-          },
-          "event_type": {
-            "description": "事件类型，用于路由",
-            "type": "string"
-          },
-          "tenant_key": {
-            "description": "租户唯一标识",
-            "type": "string"
-          },
-          "token": {
-            "description": "回调校验 token",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "schema": {
-        "description": "飞书事件协议版本",
-        "enum": [
-          "2.0"
-        ],
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "jq_root_path": ".event"
-}

cmd/event/testdata/golden/schema_board_whiteboard_text.golden

@@ -1,89 +0,0 @@
-Key:         board.whiteboard.updated_v1
-Description: Pushed when the whiteboard content is updated.
-Event:       board.whiteboard.updated_v1
-Pre-consume: yes
-
-Required Scopes:
-  - board:whiteboard:node:read
-
-Required Console Events (must be enabled in developer console):
-  - board.whiteboard.updated_v1
-
-Parameters:
-  NAME           TYPE    REQUIRED  SUB-KEY  DEFAULT  DESCRIPTION
-  whiteboard_id  string  yes       yes      -        Whiteboard id to subscribe; subscription is per-whiteboard.
-
-Output Schema:
-  {
-    "description": "飞书事件",
-    "properties": {
-      "event": {
-        "properties": {
-          "operator_ids": {
-            "items": {
-              "properties": {
-                "open_id": {
-                  "format": "open_id",
-                  "type": "string"
-                },
-                "union_id": {
-                  "format": "union_id",
-                  "type": "string"
-                },
-                "user_id": {
-                  "format": "user_id",
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "whiteboard_id": {
-            "description": "whiteboard id to subscribe",
-            "format": "whiteboard_id",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "header": {
-        "description": "事件头，所有事件结构一致",
-        "properties": {
-          "app_id": {
-            "description": "接收事件的应用 ID",
-            "type": "string"
-          },
-          "create_time": {
-            "description": "事件创建时间，毫秒时间戳字符串",
-            "type": "string"
-          },
-          "event_id": {
-            "description": "事件唯一 ID",
-            "type": "string"
-          },
-          "event_type": {
-            "description": "事件类型，用于路由",
-            "type": "string"
-          },
-          "tenant_key": {
-            "description": "租户唯一标识",
-            "type": "string"
-          },
-          "token": {
-            "description": "回调校验 token",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "schema": {
-        "description": "飞书事件协议版本",
-        "enum": [
-          "2.0"
-        ],
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }

cmd/event/testdata/golden/schema_card_action_trigger_json.golden

@@ -1,104 +0,0 @@
-{
-  "key": "card.action.trigger",
-  "display_name": "Card action",
-  "description": "Triggered when a user interacts with an interactive card (button click, form submit, dropdown select, etc.). Output includes: token (valid 30 min, max 2 updates), action details (tag, value, name, form_value), and card_content (original card in userDSL text format, auto-fetched at consume time). To update the card: parse card_content to understand the current state, construct the new card JSON, then call `lark-cli api POST /open-apis/interactive/v1/card/update` with the token (see lark-im-card-action-reply.md).",
-  "event_type": "card.action.trigger",
-  "subscription_type": "callback",
-  "schema": {
-    "custom": {}
-  },
-  "scopes": [
-    "im:message:readonly"
-  ],
-  "auth_types": [
-    "bot"
-  ],
-  "required_console_events": [
-    "card.action.trigger"
-  ],
-  "buffer_size": 100,
-  "workers": 1,
-  "single_consumer": true,
-  "resolved_output_schema": {
-    "type": "object",
-    "properties": {
-      "action_name": {
-        "type": "string",
-        "description": "Element name attribute"
-      },
-      "action_tag": {
-        "type": "string",
-        "description": "Triggered element type: button/select_static/input/checker/etc"
-      },
-      "action_value": {
-        "type": "string",
-        "description": "Developer-defined action value as JSON string"
-      },
-      "card_content": {
-        "type": "string",
-        "description": "Original card JSON content (body.content) auto-fetched via message get API at consume time using message_id; empty if message_id absent or fetch fails"
-      },
-      "chat_id": {
-        "type": "string",
-        "description": "Chat ID",
-        "format": "chat_id"
-      },
-      "checked": {
-        "type": "boolean",
-        "description": "Checkbox state (for checkbox elements)"
-      },
-      "event_id": {
-        "type": "string",
-        "description": "Globally unique event ID"
-      },
-      "form_value": {
-        "type": "string",
-        "description": "Form submission values as JSON string (only on form submit)"
-      },
-      "host": {
-        "type": "string",
-        "description": "Host type: im_message / im_top_notice"
-      },
-      "input_value": {
-        "type": "string",
-        "description": "Input field value (only for input elements)"
-      },
-      "message_id": {
-        "type": "string",
-        "description": "Message ID of the card",
-        "format": "message_id"
-      },
-      "operator_id": {
-        "type": "string",
-        "description": "Operator open_id",
-        "format": "open_id"
-      },
-      "option": {
-        "type": "string",
-        "description": "Selected option value (for single-select dropdown)"
-      },
-      "options": {
-        "type": "string",
-        "description": "Selected options, comma-separated (for multi-select)"
-      },
-      "timestamp": {
-        "type": "string",
-        "description": "Event delivery time (ms timestamp string)",
-        "format": "timestamp_ms"
-      },
-      "timezone": {
-        "type": "string",
-        "description": "User timezone for date/time picker interactions"
-      },
-      "token": {
-        "type": "string",
-        "description": "Token for delay card update (valid 30 min, max 2 updates)"
-      },
-      "type": {
-        "type": "string",
-        "description": "Event type; always card.action.trigger"
-      }
-    }
-  },
-  "jq_root_path": "."
-}

cmd/event/testdata/golden/schema_card_action_trigger_text.golden

@@ -1,92 +0,0 @@
-Key:         card.action.trigger
-Description: Triggered when a user interacts with an interactive card (button click, form submit, dropdown select, etc.). Output includes: token (valid 30 min, max 2 updates), action details (tag, value, name, form_value), and card_content (original card in userDSL text format, auto-fetched at consume time). To update the card: parse card_content to understand the current state, construct the new card JSON, then call `lark-cli api POST /open-apis/interactive/v1/card/update` with the token (see lark-im-card-action-reply.md).
-Event:       card.action.trigger
-
-Required Scopes:
-  - im:message:readonly
-
-Required Console Events (must be enabled in developer console):
-  - card.action.trigger
-
-Output Schema:
-  {
-    "type": "object",
-    "properties": {
-      "action_name": {
-        "type": "string",
-        "description": "Element name attribute"
-      },
-      "action_tag": {
-        "type": "string",
-        "description": "Triggered element type: button/select_static/input/checker/etc"
-      },
-      "action_value": {
-        "type": "string",
-        "description": "Developer-defined action value as JSON string"
-      },
-      "card_content": {
-        "type": "string",
-        "description": "Original card JSON content (body.content) auto-fetched via message get API at consume time using message_id; empty if message_id absent or fetch fails"
-      },
-      "chat_id": {
-        "type": "string",
-        "description": "Chat ID",
-        "format": "chat_id"
-      },
-      "checked": {
-        "type": "boolean",
-        "description": "Checkbox state (for checkbox elements)"
-      },
-      "event_id": {
-        "type": "string",
-        "description": "Globally unique event ID"
-      },
-      "form_value": {
-        "type": "string",
-        "description": "Form submission values as JSON string (only on form submit)"
-      },
-      "host": {
-        "type": "string",
-        "description": "Host type: im_message / im_top_notice"
-      },
-      "input_value": {
-        "type": "string",
-        "description": "Input field value (only for input elements)"
-      },
-      "message_id": {
-        "type": "string",
-        "description": "Message ID of the card",
-        "format": "message_id"
-      },
-      "operator_id": {
-        "type": "string",
-        "description": "Operator open_id",
-        "format": "open_id"
-      },
-      "option": {
-        "type": "string",
-        "description": "Selected option value (for single-select dropdown)"
-      },
-      "options": {
-        "type": "string",
-        "description": "Selected options, comma-separated (for multi-select)"
-      },
-      "timestamp": {
-        "type": "string",
-        "description": "Event delivery time (ms timestamp string)",
-        "format": "timestamp_ms"
-      },
-      "timezone": {
-        "type": "string",
-        "description": "User timezone for date/time picker interactions"
-      },
-      "token": {
-        "type": "string",
-        "description": "Token for delay card update (valid 30 min, max 2 updates)"
-      },
-      "type": {
-        "type": "string",
-        "description": "Event type; always card.action.trigger"
-      }
-    }
-  }

cmd/event/testdata/golden/schema_im_chat_updated_json.golden

@@ -1,430 +0,0 @@
-{
-  "key": "im.chat.updated_v1",
-  "display_name": "Chat updated",
-  "description": "Triggered after chat settings (owner, avatar, name, permissions, etc.) are updated",
-  "event_type": "im.chat.updated_v1",
-  "subscription_type": "event",
-  "schema": {
-    "native": {},
-    "field_overrides": {
-      "/event/after_change/owner_id/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/after_change/owner_id/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/after_change/owner_id/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      },
-      "/event/before_change/owner_id/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/before_change/owner_id/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/before_change/owner_id/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      },
-      "/event/chat_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "chat_id"
-      },
-      "/event/moderator_list/added_member_list/*/user_id/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/moderator_list/added_member_list/*/user_id/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/moderator_list/added_member_list/*/user_id/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      },
-      "/event/moderator_list/removed_member_list/*/user_id/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/moderator_list/removed_member_list/*/user_id/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/moderator_list/removed_member_list/*/user_id/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      },
-      "/event/operator_id/open_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "open_id"
-      },
-      "/event/operator_id/union_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "union_id"
-      },
-      "/event/operator_id/user_id": {
-        "Description": "",
-        "Enum": null,
-        "Kind": "user_id"
-      }
-    }
-  },
-  "scopes": [
-    "im:chat:read"
-  ],
-  "auth_types": [
-    "bot"
-  ],
-  "required_console_events": [
-    "im.chat.updated_v1"
-  ],
-  "buffer_size": 100,
-  "workers": 1,
-  "resolved_output_schema": {
-    "description": "飞书事件",
-    "properties": {
-      "event": {
-        "properties": {
-          "after_change": {
-            "properties": {
-              "add_member_permission": {
-                "type": "string"
-              },
-              "at_all_permission": {
-                "type": "string"
-              },
-              "avatar": {
-                "type": "string"
-              },
-              "description": {
-                "type": "string"
-              },
-              "edit_permission": {
-                "type": "string"
-              },
-              "group_message_type": {
-                "type": "string"
-              },
-              "i18n_names": {
-                "properties": {
-                  "en_us": {
-                    "type": "string"
-                  },
-                  "ja_jp": {
-                    "type": "string"
-                  },
-                  "zh_cn": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "join_message_visibility": {
-                "type": "string"
-              },
-              "labels": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "leave_message_visibility": {
-                "type": "string"
-              },
-              "membership_approval": {
-                "type": "string"
-              },
-              "moderation_permission": {
-                "type": "string"
-              },
-              "name": {
-                "type": "string"
-              },
-              "owner_id": {
-                "properties": {
-                  "open_id": {
-                    "format": "open_id",
-                    "type": "string"
-                  },
-                  "union_id": {
-                    "format": "union_id",
-                    "type": "string"
-                  },
-                  "user_id": {
-                    "format": "user_id",
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "restricted_mode_setting": {
-                "properties": {
-                  "download_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "message_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "screenshot_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "status": {
-                    "type": "boolean"
-                  }
-                },
-                "type": "object"
-              },
-              "share_card_permission": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "before_change": {
-            "properties": {
-              "add_member_permission": {
-                "type": "string"
-              },
-              "at_all_permission": {
-                "type": "string"
-              },
-              "avatar": {
-                "type": "string"
-              },
-              "description": {
-                "type": "string"
-              },
-              "edit_permission": {
-                "type": "string"
-              },
-              "group_message_type": {
-                "type": "string"
-              },
-              "i18n_names": {
-                "properties": {
-                  "en_us": {
-                    "type": "string"
-                  },
-                  "ja_jp": {
-                    "type": "string"
-                  },
-                  "zh_cn": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "join_message_visibility": {
-                "type": "string"
-              },
-              "labels": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "leave_message_visibility": {
-                "type": "string"
-              },
-              "membership_approval": {
-                "type": "string"
-              },
-              "moderation_permission": {
-                "type": "string"
-              },
-              "name": {
-                "type": "string"
-              },
-              "owner_id": {
-                "properties": {
-                  "open_id": {
-                    "format": "open_id",
-                    "type": "string"
-                  },
-                  "union_id": {
-                    "format": "union_id",
-                    "type": "string"
-                  },
-                  "user_id": {
-                    "format": "user_id",
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "restricted_mode_setting": {
-                "properties": {
-                  "download_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "message_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "screenshot_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "status": {
-                    "type": "boolean"
-                  }
-                },
-                "type": "object"
-              },
-              "share_card_permission": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "chat_id": {
-            "format": "chat_id",
-            "type": "string"
-          },
-          "external": {
-            "type": "boolean"
-          },
-          "moderator_list": {
-            "properties": {
-              "added_member_list": {
-                "items": {
-                  "properties": {
-                    "tenant_key": {
-                      "type": "string"
-                    },
-                    "user_id": {
-                      "properties": {
-                        "open_id": {
-                          "format": "open_id",
-                          "type": "string"
-                        },
-                        "union_id": {
-                          "format": "union_id",
-                          "type": "string"
-                        },
-                        "user_id": {
-                          "format": "user_id",
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "removed_member_list": {
-                "items": {
-                  "properties": {
-                    "tenant_key": {
-                      "type": "string"
-                    },
-                    "user_id": {
-                      "properties": {
-                        "open_id": {
-                          "format": "open_id",
-                          "type": "string"
-                        },
-                        "union_id": {
-                          "format": "union_id",
-                          "type": "string"
-                        },
-                        "user_id": {
-                          "format": "user_id",
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "operator_id": {
-            "properties": {
-              "open_id": {
-                "format": "open_id",
-                "type": "string"
-              },
-              "union_id": {
-                "format": "union_id",
-                "type": "string"
-              },
-              "user_id": {
-                "format": "user_id",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "operator_tenant_key": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "header": {
-        "description": "事件头，所有事件结构一致",
-        "properties": {
-          "app_id": {
-            "description": "接收事件的应用 ID",
-            "type": "string"
-          },
-          "create_time": {
-            "description": "事件创建时间，毫秒时间戳字符串",
-            "type": "string"
-          },
-          "event_id": {
-            "description": "事件唯一 ID",
-            "type": "string"
-          },
-          "event_type": {
-            "description": "事件类型，用于路由",
-            "type": "string"
-          },
-          "tenant_key": {
-            "description": "租户唯一标识",
-            "type": "string"
-          },
-          "token": {
-            "description": "回调校验 token",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "schema": {
-        "description": "飞书事件协议版本",
-        "enum": [
-          "2.0"
-        ],
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "jq_root_path": ".event"
-}

cmd/event/testdata/golden/schema_im_chat_updated_text.golden

@@ -1,337 +0,0 @@
-Key:         im.chat.updated_v1
-Description: Triggered after chat settings (owner, avatar, name, permissions, etc.) are updated
-Event:       im.chat.updated_v1
-
-Required Scopes:
-  - im:chat:read
-
-Required Console Events (must be enabled in developer console):
-  - im.chat.updated_v1
-
-Output Schema:
-  {
-    "description": "飞书事件",
-    "properties": {
-      "event": {
-        "properties": {
-          "after_change": {
-            "properties": {
-              "add_member_permission": {
-                "type": "string"
-              },
-              "at_all_permission": {
-                "type": "string"
-              },
-              "avatar": {
-                "type": "string"
-              },
-              "description": {
-                "type": "string"
-              },
-              "edit_permission": {
-                "type": "string"
-              },
-              "group_message_type": {
-                "type": "string"
-              },
-              "i18n_names": {
-                "properties": {
-                  "en_us": {
-                    "type": "string"
-                  },
-                  "ja_jp": {
-                    "type": "string"
-                  },
-                  "zh_cn": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "join_message_visibility": {
-                "type": "string"
-              },
-              "labels": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "leave_message_visibility": {
-                "type": "string"
-              },
-              "membership_approval": {
-                "type": "string"
-              },
-              "moderation_permission": {
-                "type": "string"
-              },
-              "name": {
-                "type": "string"
-              },
-              "owner_id": {
-                "properties": {
-                  "open_id": {
-                    "format": "open_id",
-                    "type": "string"
-                  },
-                  "union_id": {
-                    "format": "union_id",
-                    "type": "string"
-                  },
-                  "user_id": {
-                    "format": "user_id",
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "restricted_mode_setting": {
-                "properties": {
-                  "download_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "message_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "screenshot_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "status": {
-                    "type": "boolean"
-                  }
-                },
-                "type": "object"
-              },
-              "share_card_permission": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "before_change": {
-            "properties": {
-              "add_member_permission": {
-                "type": "string"
-              },
-              "at_all_permission": {
-                "type": "string"
-              },
-              "avatar": {
-                "type": "string"
-              },
-              "description": {
-                "type": "string"
-              },
-              "edit_permission": {
-                "type": "string"
-              },
-              "group_message_type": {
-                "type": "string"
-              },
-              "i18n_names": {
-                "properties": {
-                  "en_us": {
-                    "type": "string"
-                  },
-                  "ja_jp": {
-                    "type": "string"
-                  },
-                  "zh_cn": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "join_message_visibility": {
-                "type": "string"
-              },
-              "labels": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "leave_message_visibility": {
-                "type": "string"
-              },
-              "membership_approval": {
-                "type": "string"
-              },
-              "moderation_permission": {
-                "type": "string"
-              },
-              "name": {
-                "type": "string"
-              },
-              "owner_id": {
-                "properties": {
-                  "open_id": {
-                    "format": "open_id",
-                    "type": "string"
-                  },
-                  "union_id": {
-                    "format": "union_id",
-                    "type": "string"
-                  },
-                  "user_id": {
-                    "format": "user_id",
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "restricted_mode_setting": {
-                "properties": {
-                  "download_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "message_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "screenshot_has_permission_setting": {
-                    "type": "string"
-                  },
-                  "status": {
-                    "type": "boolean"
-                  }
-                },
-                "type": "object"
-              },
-              "share_card_permission": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "chat_id": {
-            "format": "chat_id",
-            "type": "string"
-          },
-          "external": {
-            "type": "boolean"
-          },
-          "moderator_list": {
-            "properties": {
-              "added_member_list": {
-                "items": {
-                  "properties": {
-                    "tenant_key": {
-                      "type": "string"
-                    },
-                    "user_id": {
-                      "properties": {
-                        "open_id": {
-                          "format": "open_id",
-                          "type": "string"
-                        },
-                        "union_id": {
-                          "format": "union_id",
-                          "type": "string"
-                        },
-                        "user_id": {
-                          "format": "user_id",
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "removed_member_list": {
-                "items": {
-                  "properties": {
-                    "tenant_key": {
-                      "type": "string"
-                    },
-                    "user_id": {
-                      "properties": {
-                        "open_id": {
-                          "format": "open_id",
-                          "type": "string"
-                        },
-                        "union_id": {
-                          "format": "union_id",
-                          "type": "string"
-                        },
-                        "user_id": {
-                          "format": "user_id",
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "operator_id": {
-            "properties": {
-              "open_id": {
-                "format": "open_id",
-                "type": "string"
-              },
-              "union_id": {
-                "format": "union_id",
-                "type": "string"
-              },
-              "user_id": {
-                "format": "user_id",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "operator_tenant_key": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "header": {
-        "description": "事件头，所有事件结构一致",
-        "properties": {
-          "app_id": {
-            "description": "接收事件的应用 ID",
-            "type": "string"
-          },
-          "create_time": {
-            "description": "事件创建时间，毫秒时间戳字符串",
-            "type": "string"
-          },
-          "event_id": {
-            "description": "事件唯一 ID",
-            "type": "string"
-          },
-          "event_type": {
-            "description": "事件类型，用于路由",
-            "type": "string"
-          },
-          "tenant_key": {
-            "description": "租户唯一标识",
-            "type": "string"
-          },
-          "token": {
-            "description": "回调校验 token",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "schema": {
-        "description": "飞书事件协议版本",
-        "enum": [
-          "2.0"
-        ],
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }

cmd/event/testdata/golden/schema_im_message_receive_json.golden

@@ -1,130 +0,0 @@
-{
-  "key": "im.message.receive_v1",
-  "display_name": "Receive message",
-  "description": "Receive IM messages",
-  "event_type": "im.message.receive_v1",
-  "subscription_type": "event",
-  "schema": {
-    "custom": {}
-  },
-  "scopes": [
-    "im:message.p2p_msg:readonly"
-  ],
-  "auth_types": [
-    "bot"
-  ],
-  "required_console_events": [
-    "im.message.receive_v1"
-  ],
-  "buffer_size": 100,
-  "workers": 1,
-  "resolved_output_schema": {
-    "type": "object",
-    "properties": {
-      "chat_id": {
-        "type": "string",
-        "description": "Chat/conversation ID; prefixed with oc_",
-        "format": "chat_id"
-      },
-      "chat_type": {
-        "type": "string",
-        "description": "Conversation type",
-        "enum": [
-          "p2p",
-          "group"
-        ]
-      },
-      "content": {
-        "type": "string",
-        "description": "Message content. For most types (text/post/image/file/audio, etc.) this is pre-rendered human-readable text."
-      },
-      "create_time": {
-        "type": "string",
-        "description": "Message creation time (ms timestamp string)",
-        "format": "timestamp_ms"
-      },
-      "event_id": {
-        "type": "string",
-        "description": "Event delivery ID. Do not use as the message deduplication key; use message_id instead."
-      },
-      "id": {
-        "type": "string",
-        "description": "Message ID (legacy alias of message_id, kept for compatibility)",
-        "format": "message_id"
-      },
-      "mentions": {
-        "type": "array",
-        "description": "Compact mentions aligned with im +messages-mget",
-        "items": {
-          "type": "object",
-          "properties": {
-            "id": {
-              "type": "string",
-              "description": "Mentioned user open_id; prefixed with ou_",
-              "format": "open_id"
-            },
-            "key": {
-              "type": "string",
-              "description": "Mention placeholder key, for example @_user_1"
-            },
-            "name": {
-              "type": "string",
-              "description": "Mentioned display name"
-            }
-          }
-        }
-      },
-      "message_id": {
-        "type": "string",
-        "description": "Message ID; prefixed with om_. Recommended idempotency key for im.message.receive_v1 consumers.",
-        "format": "message_id"
-      },
-      "message_type": {
-        "type": "string",
-        "description": "Message type"
-      },
-      "reply_to": {
-        "type": "string",
-        "description": "Parent message ID of the direct reply context, when present",
-        "format": "message_id"
-      },
-      "root_id": {
-        "type": "string",
-        "description": "Root message ID of the reply/thread context, when present",
-        "format": "message_id"
-      },
-      "sender_id": {
-        "type": "string",
-        "description": "Sender open_id; prefixed with ou_",
-        "format": "open_id"
-      },
-      "sender_type": {
-        "type": "string",
-        "description": "Sender type",
-        "enum": [
-          "user",
-          "bot"
-        ]
-      },
-      "thread_id": {
-        "type": "string",
-        "description": "Thread ID, when present"
-      },
-      "timestamp": {
-        "type": "string",
-        "description": "Event delivery time (ms timestamp string); prefers header.create_time",
-        "format": "timestamp_ms"
-      },
-      "type": {
-        "type": "string",
-        "description": "Event type; always im.message.receive_v1"
-      },
-      "update_time": {
-        "type": "string",
-        "description": "Message update time (ms timestamp string); emitted only when different from create_time",
-        "format": "timestamp_ms"
-      }
-    }
-  },
-  "jq_root_path": "."
-}

cmd/event/testdata/golden/schema_im_message_receive_text.golden

@@ -1,119 +0,0 @@
-Key:         im.message.receive_v1
-Description: Receive IM messages
-Event:       im.message.receive_v1
-
-Required Scopes:
-  - im:message.p2p_msg:readonly
-
-Required Console Events (must be enabled in developer console):
-  - im.message.receive_v1
-
-Output Schema:
-  {
-    "type": "object",
-    "properties": {
-      "chat_id": {
-        "type": "string",
-        "description": "Chat/conversation ID; prefixed with oc_",
-        "format": "chat_id"
-      },
-      "chat_type": {
-        "type": "string",
-        "description": "Conversation type",
-        "enum": [
-          "p2p",
-          "group"
-        ]
-      },
-      "content": {
-        "type": "string",
-        "description": "Message content. For most types (text/post/image/file/audio, etc.) this is pre-rendered human-readable text."
-      },
-      "create_time": {
-        "type": "string",
-        "description": "Message creation time (ms timestamp string)",
-        "format": "timestamp_ms"
-      },
-      "event_id": {
-        "type": "string",
-        "description": "Event delivery ID. Do not use as the message deduplication key; use message_id instead."
-      },
-      "id": {
-        "type": "string",
-        "description": "Message ID (legacy alias of message_id, kept for compatibility)",
-        "format": "message_id"
-      },
-      "mentions": {
-        "type": "array",
-        "description": "Compact mentions aligned with im +messages-mget",
-        "items": {
-          "type": "object",
-          "properties": {
-            "id": {
-              "type": "string",
-              "description": "Mentioned user open_id; prefixed with ou_",
-              "format": "open_id"
-            },
-            "key": {
-              "type": "string",
-              "description": "Mention placeholder key, for example @_user_1"
-            },
-            "name": {
-              "type": "string",
-              "description": "Mentioned display name"
-            }
-          }
-        }
-      },
-      "message_id": {
-        "type": "string",
-        "description": "Message ID; prefixed with om_. Recommended idempotency key for im.message.receive_v1 consumers.",
-        "format": "message_id"
-      },
-      "message_type": {
-        "type": "string",
-        "description": "Message type"
-      },
-      "reply_to": {
-        "type": "string",
-        "description": "Parent message ID of the direct reply context, when present",
-        "format": "message_id"
-      },
-      "root_id": {
-        "type": "string",
-        "description": "Root message ID of the reply/thread context, when present",
-        "format": "message_id"
-      },
-      "sender_id": {
-        "type": "string",
-        "description": "Sender open_id; prefixed with ou_",
-        "format": "open_id"
-      },
-      "sender_type": {
-        "type": "string",
-        "description": "Sender type",
-        "enum": [
-          "user",
-          "bot"
-        ]
-      },
-      "thread_id": {
-        "type": "string",
-        "description": "Thread ID, when present"
-      },
-      "timestamp": {
-        "type": "string",
-        "description": "Event delivery time (ms timestamp string); prefers header.create_time",
-        "format": "timestamp_ms"
-      },
-      "type": {
-        "type": "string",
-        "description": "Event type; always im.message.receive_v1"
-      },
-      "update_time": {
-        "type": "string",
-        "description": "Message update time (ms timestamp string); emitted only when different from create_time",
-        "format": "timestamp_ms"
-      }
-    }
-  }

cmd/event/wiring.go

@@ -1,25 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package event
-
-import (
-	"fmt"
-
-	"github.com/larksuite/cli/events"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// compileCatalog is the event command tree's single assembly point: it turns
-// the aggregated domain declarations into the immutable snapshot every
-// subcommand reads. A compile failure is a defect in declarations built into
-// this binary — there is nothing to recover at runtime, so it panics.
-func compileCatalog() *catalog.Snapshot {
-	// The strategy registry that validates references is the same one that
-	// executes them, so "compiled" implies "resolvable at run time".
-	snap, err := catalog.Compile(events.All(), consumeStrategies)
-	if err != nil {
-		panic(fmt.Sprintf("event catalog failed to compile: %v", err))
-	}
-	return snap
-}

events/application/menu.go

@@ -9,7 +9,6 @@ import (
 	"strings"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // BotMenuOutput is the flattened shape for application.bot.menu_v6.
@@ -30,6 +29,13 @@ type BotMenuOutput struct {
 
 func processBotMenu(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+			AppID      string `json:"app_id"`
+			TenantKey  string `json:"tenant_key"`
+		} `json:"header"`
 		Event struct {
 			EventKey  string          `json:"event_key"`
 			Timestamp json.RawMessage `json:"timestamp"`
@@ -44,11 +50,11 @@ func processBotMenu(_ context.Context, _ event.APIClient, raw *event.RawEvent, _
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	menuTimestamp := timestampMillisString(envelope.Event.Timestamp)
-	timestamp := raw.SourceTime
+	timestamp := envelope.Header.CreateTime
 	if timestamp == "" {
 		timestamp = menuTimestamp
 	}
@@ -56,10 +62,10 @@ func processBotMenu(_ context.Context, _ event.APIClient, raw *event.RawEvent, _
 
 	out := &BotMenuOutput{
 		Type:            eventTypeBotMenuV6,
-		EventID:         raw.EventID,
+		EventID:         envelope.Header.EventID,
 		Timestamp:       timestamp,
-		AppID:           raw.AppID,
-		TenantKey:       raw.TenantKey,
+		AppID:           envelope.Header.AppID,
+		TenantKey:       envelope.Header.TenantKey,
 		EventKey:        envelope.Event.EventKey,
 		MenuTimestamp:   menuTimestamp,
 		OperatorID:      operatorID,

events/application/menu_test.go

@@ -11,8 +11,6 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 func TestKeysBotMenuMetadata(t *testing.T) {
@@ -53,15 +51,14 @@ func TestKeysBotMenuMetadata(t *testing.T) {
 
 func TestBotMenuRegistersCleanly(t *testing.T) {
 	const key = eventTypeBotMenuV6
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
+	event.UnregisterKeyForTest(key)
+	t.Cleanup(func() { event.UnregisterKeyForTest(key) })
+
+	for _, def := range Keys() {
+		event.RegisterKey(def)
 	}
-	if _, ok := snap.Resolve(key); !ok {
-		t.Fatalf("snap.Resolve(%q): key missing from compiled catalog", key)
+	if _, ok := event.Lookup(key); !ok {
+		t.Fatalf("event.Lookup(%q) not registered", key)
 	}
 }
 
@@ -202,42 +199,14 @@ func TestProcessBotMenuMalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processBotMenu(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
-// fillCanonicalFromHeader copies the payload envelope header metadata onto
-// the RawEvent canonical fields. Process handlers read event_id, create_time,
-// app_id, and tenant_key from the RawEvent, which the consume pipeline fills
-// from the envelope header before dispatch; tests that hand-build a RawEvent
-// must mirror that so both views agree.
-func fillCanonicalFromHeader(t *testing.T, raw *event.RawEvent) {
-	t.Helper()
-	var envelope struct {
-		Header struct {
-			EventID    string `json:"event_id"`
-			EventType  string `json:"event_type"`
-			CreateTime string `json:"create_time"`
-			AppID      string `json:"app_id"`
-			TenantKey  string `json:"tenant_key"`
-		} `json:"header"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		t.Fatalf("parse envelope header: %v", err)
-	}
-	raw.EventID = envelope.Header.EventID
-	if envelope.Header.EventType != "" {
-		raw.EventType = envelope.Header.EventType
-	}
-	raw.SourceTime = envelope.Header.CreateTime
-	raw.AppID = envelope.Header.AppID
-	raw.TenantKey = envelope.Header.TenantKey
-}
-
 func runBotMenu(t *testing.T, payload string) BotMenuOutput {
 	t.Helper()
 	raw := &event.RawEvent{
@@ -246,7 +215,6 @@ func runBotMenu(t *testing.T, payload string) BotMenuOutput {
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processBotMenu(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("processBotMenu: %v", err)

events/approval/preconsume.go

@@ -13,13 +13,23 @@ import (
 	"github.com/larksuite/cli/internal/event"
 )
 
-func approvalSubscriptionPreConsume(eventType, subscribePath string) func(context.Context, event.APIClient, map[string]string) (func() error, error) {
+type approvalEventType string
+type approvalSubscriptionPath string
+
+type approvalSubscriptionConfig struct {
+	eventType     approvalEventType
+	subscribePath approvalSubscriptionPath
+}
+
+func approvalSubscriptionPreConsume(cfg approvalSubscriptionConfig) func(context.Context, event.APIClient, map[string]string) (func() error, error) {
 	return func(ctx context.Context, rt event.APIClient, params map[string]string) (func() error, error) {
 		if rt == nil {
 			return nil, errs.NewInternalError(errs.SubtypeUnknown,
 				"runtime API client is required for pre-consume subscription")
 		}
 
+		eventType := string(cfg.eventType)
+		subscribePath := string(cfg.subscribePath)
 		subscriptionTypes, err := approvalSubscriptionTypes(eventType, params)
 		if err != nil {
 			return nil, err

events/approval/register.go

@@ -10,7 +10,6 @@ import (
 	"reflect"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 const (
@@ -41,9 +40,12 @@ func Keys() []event.KeyDefinition {
 			Schema: event.SchemaDef{
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(ApprovalInstanceStatusChangedV4Output{})},
 			},
-			Process:    processApprovalInstanceStatusChanged,
-			PreConsume: approvalSubscriptionPreConsume(eventTypeApprovalInstanceStatusChangedV4, pathApprovalInstancesSubscription),
-			Scopes:     []string{"approval:instance:read"},
+			Process: processApprovalInstanceStatusChanged,
+			PreConsume: approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+				eventType:     eventTypeApprovalInstanceStatusChangedV4,
+				subscribePath: pathApprovalInstancesSubscription,
+			}),
+			Scopes: []string{"approval:instance:read"},
 			AuthTypes: []string{
 				"user",
 			},
@@ -58,9 +60,12 @@ func Keys() []event.KeyDefinition {
 			Schema: event.SchemaDef{
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(ApprovalTaskStatusChangedV4Output{})},
 			},
-			Process:    processApprovalTaskStatusChanged,
-			PreConsume: approvalSubscriptionPreConsume(eventTypeApprovalTaskStatusChangedV4, pathApprovalTasksSubscription),
-			Scopes:     []string{"approval:task:read"},
+			Process: processApprovalTaskStatusChanged,
+			PreConsume: approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+				eventType:     eventTypeApprovalTaskStatusChangedV4,
+				subscribePath: pathApprovalTasksSubscription,
+			}),
+			Scopes: []string{"approval:task:read"},
 			AuthTypes: []string{
 				"user",
 			},
@@ -94,6 +99,11 @@ func processApprovalInstanceStatusChanged(_ context.Context, _ event.APIClient,
 		return nil, nil
 	}
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			ApprovalCode string          `json:"approval_code"`
 			InstanceCode string          `json:"instance_code"`
@@ -104,13 +114,13 @@ func processApprovalInstanceStatusChanged(_ context.Context, _ event.APIClient,
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	out := &ApprovalInstanceStatusChangedV4Output{
-		Type:         raw.EventType,
-		EventID:      raw.EventID,
-		Timestamp:    raw.SourceTime,
+		Type:         envelope.Header.EventType,
+		EventID:      envelope.Header.EventID,
+		Timestamp:    envelope.Header.CreateTime,
 		ApprovalCode: envelope.Event.ApprovalCode,
 		InstanceCode: envelope.Event.InstanceCode,
 		ExternalID:   envelope.Event.ExternalID,
@@ -118,6 +128,9 @@ func processApprovalInstanceStatusChanged(_ context.Context, _ event.APIClient,
 		OperateTime:  envelope.Event.OperateTime,
 		StartUser:    envelope.Event.StartUser,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	return json.Marshal(out)
 }
 
@@ -126,6 +139,11 @@ func processApprovalTaskStatusChanged(_ context.Context, _ event.APIClient, raw
 		return nil, nil
 	}
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			ApprovalCode   string          `json:"approval_code"`
 			InstanceCode   string          `json:"instance_code"`
@@ -138,13 +156,13 @@ func processApprovalTaskStatusChanged(_ context.Context, _ event.APIClient, raw
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	out := &ApprovalTaskStatusChangedV4Output{
-		Type:           raw.EventType,
-		EventID:        raw.EventID,
-		Timestamp:      raw.SourceTime,
+		Type:           envelope.Header.EventType,
+		EventID:        envelope.Header.EventID,
+		Timestamp:      envelope.Header.CreateTime,
 		ApprovalCode:   envelope.Event.ApprovalCode,
 		InstanceCode:   envelope.Event.InstanceCode,
 		TaskID:         envelope.Event.TaskID,
@@ -154,5 +172,8 @@ func processApprovalTaskStatusChanged(_ context.Context, _ event.APIClient, raw
 		Status:         envelope.Event.Status,
 		OperateTime:    envelope.Event.OperateTime,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	return json.Marshal(out)
 }

events/approval/register_test.go

@@ -14,8 +14,6 @@ import (
 
 	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
-	"github.com/larksuite/cli/internal/event/processing"
 	"github.com/larksuite/cli/internal/event/schemas"
 )
 
@@ -257,7 +255,10 @@ func TestApprovalPreConsumeRegistersSubscriptionTypesWithoutCleanup(t *testing.T
 
 	for _, tc := range tests {
 		t.Run(tc.name, func(t *testing.T) {
-			pc := approvalSubscriptionPreConsume(tc.eventType, tc.subscribePath)
+			pc := approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+				eventType:     approvalEventType(tc.eventType),
+				subscribePath: approvalSubscriptionPath(tc.subscribePath),
+			})
 			rt := &fakeAPIClient{}
 			cleanup, err := pc(context.Background(), rt, tc.params)
 			if err != nil {
@@ -296,7 +297,9 @@ func assertCall(t *testing.T, got recordedCall, wantMethod, wantPath string, wan
 
 func TestApprovalPreConsumeValidationErrors(t *testing.T) {
 	t.Run("nil runtime", func(t *testing.T) {
-		pc := approvalSubscriptionPreConsume(eventTypeApprovalInstanceStatusChangedV4, "")
+		pc := approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+			eventType: eventTypeApprovalInstanceStatusChangedV4,
+		})
 		_, err := pc(context.Background(), nil, map[string]string{"subscription_type": approvalSubscriptionTypeInvolved})
 		if err == nil {
 			t.Fatal("expected nil runtime error")
@@ -309,7 +312,9 @@ func TestApprovalPreConsumeValidationErrors(t *testing.T) {
 
 	for _, raw := range []string{"BAD", "[]", `["INVOLVED_APPROVAL",3]`} {
 		t.Run("invalid subscription type "+raw, func(t *testing.T) {
-			pc := approvalSubscriptionPreConsume(eventTypeApprovalInstanceStatusChangedV4, "")
+			pc := approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+				eventType: eventTypeApprovalInstanceStatusChangedV4,
+			})
 			cleanup, err := pc(context.Background(), &fakeAPIClient{}, map[string]string{"subscription_type": raw})
 			if err == nil {
 				t.Fatal("expected invalid subscription_type error")
@@ -333,7 +338,10 @@ func TestApprovalPreConsumeValidationErrors(t *testing.T) {
 	t.Run("partial registration failure reports registered and failed relation types", func(t *testing.T) {
 		upstream := errs.NewAPIError(errs.SubtypeServerError, "approval subscription API failed")
 		rt := &fakeAPIClient{err: upstream, errOnCall: 2}
-		pc := approvalSubscriptionPreConsume(eventTypeApprovalTaskStatusChangedV4, pathApprovalTasksSubscription)
+		pc := approvalSubscriptionPreConsume(approvalSubscriptionConfig{
+			eventType:     eventTypeApprovalTaskStatusChangedV4,
+			subscribePath: pathApprovalTasksSubscription,
+		})
 
 		cleanup, err := pc(context.Background(), rt, map[string]string{})
 		if err == nil {
@@ -545,7 +553,7 @@ func TestProcessApprovalStatusChangedUsesRawEventTypeFallback(t *testing.T) {
 	}
 }
 
-func TestProcessApprovalStatusChangedMalformedPayloadDrop(t *testing.T) {
+func TestProcessApprovalStatusChangedMalformedPayloadPassthrough(t *testing.T) {
 	for _, tc := range []struct {
 		name      string
 		eventType string
@@ -561,11 +569,11 @@ func TestProcessApprovalStatusChangedMalformedPayloadDrop(t *testing.T) {
 				Timestamp: time.Now(),
 			}
 			got, err := tc.process(context.Background(), nil, raw, nil)
-			if !processing.IsDropMalformed(err) {
-				t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+			if err != nil {
+				t.Fatalf("Process should swallow parse errors, got %v", err)
 			}
-			if got != nil {
-				t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+			if string(got) != "not json" {
+				t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 			}
 		})
 	}
@@ -591,30 +599,6 @@ func TestProcessApprovalStatusChangedNilRaw(t *testing.T) {
 	}
 }
 
-// fillCanonicalFromHeader copies the payload envelope header metadata onto
-// the RawEvent canonical fields. Process handlers read event_id and
-// create_time from the RawEvent, which the consume pipeline fills from the
-// envelope header before dispatch; tests that hand-build a RawEvent must
-// mirror that so both views agree.
-func fillCanonicalFromHeader(t *testing.T, raw *event.RawEvent) {
-	t.Helper()
-	var envelope struct {
-		Header struct {
-			EventID    string `json:"event_id"`
-			EventType  string `json:"event_type"`
-			CreateTime string `json:"create_time"`
-		} `json:"header"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		t.Fatalf("parse envelope header: %v", err)
-	}
-	raw.EventID = envelope.Header.EventID
-	if envelope.Header.EventType != "" {
-		raw.EventType = envelope.Header.EventType
-	}
-	raw.SourceTime = envelope.Header.CreateTime
-}
-
 func runApprovalInstanceStatusChanged(t *testing.T, payload string) ApprovalInstanceStatusChangedV4Output {
 	t.Helper()
 	raw := &event.RawEvent{
@@ -622,7 +606,6 @@ func runApprovalInstanceStatusChanged(t *testing.T, payload string) ApprovalInst
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processApprovalInstanceStatusChanged(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process returned error: %v", err)
@@ -641,7 +624,6 @@ func runApprovalTaskStatusChanged(t *testing.T, payload string) ApprovalTaskStat
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processApprovalTaskStatusChanged(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process returned error: %v", err)
@@ -654,16 +636,17 @@ func runApprovalTaskStatusChanged(t *testing.T, payload string) ApprovalTaskStat
 }
 
 func TestApprovalKeysRegisterCleanly(t *testing.T) {
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
+	for _, key := range []string{eventTypeApprovalInstanceStatusChangedV4, eventTypeApprovalTaskStatusChangedV4} {
+		event.UnregisterKeyForTest(key)
+		t.Cleanup(func() { event.UnregisterKeyForTest(key) })
+	}
+
+	for _, def := range Keys() {
+		event.RegisterKey(def)
 	}
 	for _, key := range []string{eventTypeApprovalInstanceStatusChangedV4, eventTypeApprovalTaskStatusChangedV4} {
-		if _, ok := snap.Resolve(key); !ok {
-			t.Fatalf("snap.Resolve(%q): key missing from compiled catalog", key)
+		if _, ok := event.Lookup(key); !ok {
+			t.Fatalf("event.Lookup(%q) not registered", key)
 		}
 	}
 }

events/arch_test.go

@@ -1,356 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-// Architecture gates for the events declaration layer.
-//
-// events/<domain> packages are declarations: EventKeys, payload shapes, and
-// processing hooks. Two kinds of rot would quietly destroy that role:
-//
-//  1. Importing command wiring, a transport host, or a concrete adapter turns
-//     declarations into another place where process and transport concerns
-//     accumulate, and drags the whole adapter tree into every binary that
-//     only wanted the catalog.
-//  2. Re-parsing the envelope header inside a domain duplicates the kernel's
-//     single header decode; the copies then drift apart the day the envelope
-//     evolves.
-//
-// These tests turn both into build breaks.
-package events_test
-
-import (
-	"go/ast"
-	"go/parser"
-	"go/token"
-	"io/fs"
-	"path/filepath"
-	"reflect"
-	"slices"
-	"sort"
-	"strconv"
-	"strings"
-	"testing"
-)
-
-const (
-	archModulePath          = "github.com/larksuite/cli"
-	archAdapterImportPrefix = archModulePath + "/internal/event/adapter"
-)
-
-// archProductionGoFiles returns every non-test .go file under root,
-// skipping testdata directories. Paths are relative to root.
-func archProductionGoFiles(t *testing.T, root string) []string {
-	t.Helper()
-	var files []string
-	err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
-		if err != nil {
-			return err
-		}
-		if d.IsDir() {
-			if d.Name() == "testdata" {
-				return fs.SkipDir
-			}
-			return nil
-		}
-		if !strings.HasSuffix(path, ".go") || strings.HasSuffix(path, "_test.go") {
-			return nil
-		}
-		files = append(files, path)
-		return nil
-	})
-	if err != nil {
-		t.Fatalf("walk %s: %v", root, err)
-	}
-	sort.Strings(files)
-	return files
-}
-
-// archForbiddenDomainImport reports why importPath is banned in events/, if
-// it is. Domains may use the kernel (internal/event, model, catalog,
-// processing, ...); they must never see the layers that host or transport
-// them.
-func archForbiddenDomainImport(importPath string) (reason string, banned bool) {
-	switch importPath {
-	case "github.com/spf13/cobra":
-		return "CLI framework; command wiring lives in cmd, a declaration that needs cobra has stopped being a declaration", true
-	case archModulePath + "/internal/event/bus":
-		return "bus is a host process; a domain importing its host inverts the dependency direction", true
-	case archModulePath + "/internal/event/consume":
-		return "consume is a host process; a domain importing its host inverts the dependency direction", true
-	}
-	if importPath == archAdapterImportPrefix || strings.HasPrefix(importPath, archAdapterImportPrefix+"/") {
-		return "concrete adapter; domains must stay transport-agnostic so any host can serve them", true
-	}
-	return "", false
-}
-
-// TestArchEventsImportRedline fails when any production file under events/
-// imports command wiring, an event host, or a concrete adapter. It keeps the
-// declaration layer linkable everywhere without pulling in transports.
-func TestArchEventsImportRedline(t *testing.T) {
-	files := archProductionGoFiles(t, ".")
-	if len(files) == 0 {
-		t.Fatal("scanned zero production files under events/ — the gate is idling; fix the walker before trusting any green run")
-	}
-	fset := token.NewFileSet()
-	for _, file := range files {
-		f, err := parser.ParseFile(fset, file, nil, parser.ImportsOnly)
-		if err != nil {
-			t.Fatalf("parse %s: %v", file, err)
-		}
-		for _, imp := range f.Imports {
-			path, err := strconv.Unquote(imp.Path.Value)
-			if err != nil {
-				t.Fatalf("unquote import in %s: %v", file, err)
-			}
-			if reason, banned := archForbiddenDomainImport(path); banned {
-				t.Errorf("%s imports %q: %s", filepath.ToSlash(file), path, reason)
-			}
-		}
-	}
-}
-
-// envelopeHeaderTags are the metadata fields the kernel decodes exactly once
-// from the envelope header. A domain that re-declares any of them inside a
-// json:"header" block is re-parsing the envelope instead of consuming the
-// kernel's decode — the duplicate drifts silently when the envelope changes.
-var envelopeHeaderTags = map[string]bool{
-	"event_id":    true,
-	"event_type":  true,
-	"create_time": true,
-	"app_id":      true,
-	"tenant_key":  true,
-}
-
-// headerReparseBaseline is the ratchet of pinned pre-existing residue, keyed
-// by file (relative to events/) with the header metadata tags it re-parses.
-// It is empty: every domain consumes the kernel-decoded header, so the gate
-// runs at zero tolerance. Never add an entry — new code must read the
-// kernel-decoded header instead of unmarshalling the envelope again.
-var headerReparseBaseline = map[string][]string{}
-
-type archHeaderReparse struct {
-	file  string // slash path relative to events/
-	line  int
-	field string // Go field name inside the header block
-	tag   string // offending json tag
-}
-
-// archJSONTagName extracts the json name (first comma segment) from a struct
-// field tag, or "" when absent.
-func archJSONTagName(field *ast.Field) string {
-	if field.Tag == nil {
-		return ""
-	}
-	raw, err := strconv.Unquote(field.Tag.Value)
-	if err != nil {
-		return ""
-	}
-	name, _, _ := strings.Cut(reflect.StructTag(raw).Get("json"), ",")
-	return name
-}
-
-// archNamedStructIndex maps type names declared in the given files (one
-// package) to their struct bodies, so a json:"header" field with a named
-// type still resolves.
-func archNamedStructIndex(files []*ast.File) map[string]*ast.StructType {
-	index := make(map[string]*ast.StructType)
-	for _, f := range files {
-		for _, decl := range f.Decls {
-			gen, ok := decl.(*ast.GenDecl)
-			if !ok || gen.Tok != token.TYPE {
-				continue
-			}
-			for _, spec := range gen.Specs {
-				ts, ok := spec.(*ast.TypeSpec)
-				if !ok {
-					continue
-				}
-				if st, ok := ts.Type.(*ast.StructType); ok {
-					index[ts.Name.Name] = st
-				}
-			}
-		}
-	}
-	return index
-}
-
-// archStructBody resolves expr to a struct body: inline struct types,
-// pointers to them, and named types declared in the same package.
-func archStructBody(expr ast.Expr, named map[string]*ast.StructType) *ast.StructType {
-	switch v := expr.(type) {
-	case *ast.StructType:
-		return v
-	case *ast.StarExpr:
-		return archStructBody(v.X, named)
-	case *ast.Ident:
-		return named[v.Name]
-	}
-	return nil
-}
-
-// archFindHeaderReparses flags every field inside a json:"header" struct
-// block whose json tag re-declares envelope header metadata. Fields outside
-// header blocks are never flagged: a domain body owning its own create_time
-// (e.g. a message's own timestamps) is legitimate.
-func archFindHeaderReparses(fset *token.FileSet, file *ast.File, relPath string, named map[string]*ast.StructType) []archHeaderReparse {
-	var found []archHeaderReparse
-	ast.Inspect(file, func(n ast.Node) bool {
-		st, ok := n.(*ast.StructType)
-		if !ok {
-			return true
-		}
-		for _, field := range st.Fields.List {
-			if archJSONTagName(field) != "header" {
-				continue
-			}
-			body := archStructBody(field.Type, named)
-			if body == nil {
-				continue
-			}
-			for _, hf := range body.Fields.List {
-				tag := archJSONTagName(hf)
-				if !envelopeHeaderTags[tag] {
-					continue
-				}
-				name := "(embedded)"
-				if len(hf.Names) > 0 {
-					parts := make([]string, len(hf.Names))
-					for i, ident := range hf.Names {
-						parts[i] = ident.Name
-					}
-					name = strings.Join(parts, ",")
-				}
-				found = append(found, archHeaderReparse{
-					file:  relPath,
-					line:  fset.Position(hf.Pos()).Line,
-					field: name,
-					tag:   tag,
-				})
-			}
-		}
-		return true
-	})
-	return found
-}
-
-// TestArchEventsNoHeaderMetadataReparse fails when a production file under
-// events/ declares a json:"header" struct block that re-parses envelope
-// header metadata, except for the pinned pre-existing residue in
-// headerReparseBaseline (which may only shrink).
-func TestArchEventsNoHeaderMetadataReparse(t *testing.T) {
-	files := archProductionGoFiles(t, ".")
-	if len(files) == 0 {
-		t.Fatal("scanned zero production files under events/ — the gate is idling; fix the walker before trusting any green run")
-	}
-
-	// Parse per directory so named header types declared in a sibling file
-	// of the same package still resolve.
-	byDir := make(map[string][]string)
-	for _, file := range files {
-		dir := filepath.Dir(file)
-		byDir[dir] = append(byDir[dir], file)
-	}
-	dirs := make([]string, 0, len(byDir))
-	for dir := range byDir {
-		dirs = append(dirs, dir)
-	}
-	sort.Strings(dirs)
-
-	fset := token.NewFileSet()
-	var violations []archHeaderReparse
-	for _, dir := range dirs {
-		astFiles := make([]*ast.File, 0, len(byDir[dir]))
-		for _, file := range byDir[dir] {
-			f, err := parser.ParseFile(fset, file, nil, parser.SkipObjectResolution)
-			if err != nil {
-				t.Fatalf("parse %s: %v", file, err)
-			}
-			astFiles = append(astFiles, f)
-		}
-		named := archNamedStructIndex(astFiles)
-		for i, f := range astFiles {
-			rel := filepath.ToSlash(byDir[dir][i])
-			violations = append(violations, archFindHeaderReparses(fset, f, rel, named)...)
-		}
-	}
-
-	seen := make(map[string]bool)
-	for _, v := range violations {
-		seen[v.file+"\x00"+v.tag] = true
-		if slices.Contains(headerReparseBaseline[v.file], v.tag) {
-			continue
-		}
-		t.Errorf("%s:%d field %s re-parses envelope header metadata %q inside a json:\"header\" block — consume the kernel-decoded header instead of unmarshalling the envelope again", v.file, v.line, v.field, v.tag)
-	}
-
-	// Stale baseline entries: once a file stops re-parsing a tag, its entry
-	// must go, otherwise the ratchet is wider than reality and the cleanup
-	// can silently regress.
-	for file, tags := range headerReparseBaseline {
-		for _, tag := range tags {
-			if !seen[file+"\x00"+tag] {
-				t.Errorf("stale baseline entry %s / %q: no code matches it anymore — delete the entry so the cleanup is locked in", file, tag)
-			}
-		}
-	}
-}
-
-// TestArchEventsHeaderReparseDetectorSelfCheck runs the header-reparse
-// detector on synthetic sources with a known violation count. If the
-// detector rots (tag parsing, named-type resolution, header matching), the
-// main gate would report green on a violating tree; this test makes that
-// failure mode loud.
-func TestArchEventsHeaderReparseDetectorSelfCheck(t *testing.T) {
-	parse := func(src string) []archHeaderReparse {
-		t.Helper()
-		fset := token.NewFileSet()
-		f, err := parser.ParseFile(fset, "synthetic.go", src, parser.SkipObjectResolution)
-		if err != nil {
-			t.Fatalf("parse synthetic source: %v", err)
-		}
-		files := []*ast.File{f}
-		return archFindHeaderReparses(fset, f, "synthetic.go", archNamedStructIndex(files))
-	}
-
-	const violating = `package synth
-
-type namedHeader struct {
-	AppID string ` + "`json:\"app_id\"`" + `
-}
-
-type envelope struct {
-	Header struct {
-		EventID   string ` + "`json:\"event_id\"`" + `
-		TenantKey string ` + "`json:\"tenant_key,omitempty\"`" + `
-		Custom    string ` + "`json:\"custom\"`" + `
-	} ` + "`json:\"header,omitempty\"`" + `
-	Named *namedHeader ` + "`json:\"header\"`" + `
-	Body  struct {
-		CreateTime string ` + "`json:\"create_time\"`" + `
-	} ` + "`json:\"body\"`" + `
-}
-`
-	got := parse(violating)
-	gotIDs := make([]string, len(got))
-	for i, v := range got {
-		gotIDs[i] = v.field + ":" + v.tag
-	}
-	sort.Strings(gotIDs)
-	wantIDs := []string{"AppID:app_id", "EventID:event_id", "TenantKey:tenant_key"}
-	if !slices.Equal(gotIDs, wantIDs) {
-		t.Fatalf("detector self-check: flagged %v, want exactly %v — the detector has drifted and the main gate cannot be trusted", gotIDs, wantIDs)
-	}
-
-	const clean = `package synth
-
-type output struct {
-	EventID string ` + "`json:\"event_id\"`" + `
-	Header  struct {
-		Custom string ` + "`json:\"custom\"`" + `
-	} ` + "`json:\"header\"`" + `
-}
-`
-	if got := parse(clean); len(got) != 0 {
-		t.Fatalf("detector self-check: clean synthetic source flagged %+v — the detector over-triggers and will produce false reds", got)
-	}
-}

events/catalog_helper_test.go

@@ -1,26 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"testing"
-
-	"github.com/larksuite/cli/events"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// compileRealCatalog compiles the full shipped declaration set exactly as the
-// runtime does. Tests that used to walk the global registry iterate this
-// snapshot instead.
-func compileRealCatalog(t *testing.T) *catalog.Snapshot {
-	t.Helper()
-	snap, err := catalog.Compile(events.All(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("compile catalog: %v", err)
-	}
-	return snap
-}

events/compile_test.go

@@ -1,93 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"encoding/json"
-	"testing"
-
-	"github.com/larksuite/cli/events"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// This gate lives in the events package because the catalog package cannot
-// import the declarations it compiles (that would be an import cycle). It is
-// the acceptance half of the compiler's own rejection tests: the real catalog
-// must compile — a compiler that rejects everything would also pass those.
-func TestCompile_RealCatalogCompilesCleanly(t *testing.T) {
-	snap, err := catalog.Compile(events.All(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("the shipped declarations must compile: %v", err)
-	}
-	if snap.Len() == 0 {
-		t.Fatal("the compiled catalog is empty; the gate proved nothing")
-	}
-	if snap.Len() != len(expectedKeys) {
-		t.Fatalf("compiled %d keys, frozen baseline has %d", snap.Len(), len(expectedKeys))
-	}
-	for _, want := range expectedKeys {
-		if _, ok := snap.Resolve(want); !ok {
-			t.Errorf("baseline key missing from the compiled catalog: %s", want)
-		}
-	}
-}
-
-// Every shipped key must satisfy its compiled output contract: a resolvable
-// non-empty schema, a jq root that matches the output mode, and normalized
-// delivery values. Golden files pin a few representative keys byte-for-byte;
-// this covers the whole catalog structurally.
-func TestOutputContract_HoldsForEveryKey(t *testing.T) {
-	snap, err := catalog.Compile(events.All(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	checked := 0
-	for _, entry := range snap.Entries() {
-		checked++
-		d := entry.Descriptor()
-		out := entry.Output()
-
-		var parsed map[string]json.RawMessage
-		if err := json.Unmarshal(out.SchemaJSON, &parsed); err != nil || len(parsed) == 0 {
-			t.Errorf("%s: resolved schema must be a non-empty JSON object (err=%v)", d.Key, err)
-		}
-
-		switch out.Mode {
-		case catalog.OutputNative:
-			if out.JQRootPath != ".event" {
-				t.Errorf("%s: native keys deliver the V2 envelope; jq root must be .event, got %q", d.Key, out.JQRootPath)
-			}
-			if entry.Binding().Process != nil {
-				t.Errorf("%s: native keys must not carry a processor", d.Key)
-			}
-		case catalog.OutputProcessed:
-			if out.JQRootPath != "." {
-				t.Errorf("%s: processed keys deliver a flat shape; jq root must be ., got %q", d.Key, out.JQRootPath)
-			}
-			if entry.Binding().Process == nil {
-				t.Errorf("%s: processed keys must carry a processor", d.Key)
-			}
-		default:
-			t.Errorf("%s: unknown output mode %q", d.Key, out.Mode)
-		}
-
-		cap := entry.Capability()
-		if cap.BufferSize <= 0 || cap.BufferSize > catalog.MaxBufferSize || cap.Workers <= 0 {
-			t.Errorf("%s: delivery values must be normalized, got buffer=%d workers=%d", d.Key, cap.BufferSize, cap.Workers)
-		}
-		if d.Domain == "" {
-			t.Errorf("%s: descriptor domain must always be resolved", d.Key)
-		}
-	}
-	if checked == 0 {
-		t.Fatal("no entries were checked; the gate proved nothing")
-	}
-}

events/expected_keys_test.go

@@ -1,59 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"testing"
-)
-
-// expectedKeys is the frozen catalog baseline. Adding, removing, or renaming
-// an EventKey is a deliberate contract change: update this list in the same
-// commit and call the change out in the changelog.
-var expectedKeys = []string{
-	"application.bot.menu_v6",
-	"approval.instance.status_changed_v4",
-	"approval.task.status_changed_v4",
-	"board.whiteboard.updated_v1",
-	"card.action.trigger",
-	"im.chat.disbanded_v1",
-	"im.chat.member.bot.added_v1",
-	"im.chat.member.bot.deleted_v1",
-	"im.chat.member.user.added_v1",
-	"im.chat.member.user.deleted_v1",
-	"im.chat.member.user.withdrawn_v1",
-	"im.chat.updated_v1",
-	"im.message.message_read_v1",
-	"im.message.reaction.created_v1",
-	"im.message.reaction.deleted_v1",
-	"im.message.receive_v1",
-	"minutes.minute.generated_v1",
-	"task.task.update_user_access_v2",
-	"vc.meeting.participant_meeting_ended_v1",
-	"vc.meeting.participant_meeting_joined_v1",
-	"vc.meeting.participant_meeting_started_v1",
-	"vc.note.generated_v1",
-	"vc.recording.recording_ended_v1",
-	"vc.recording.recording_started_v1",
-	"vc.recording.recording_transcript_generated_v1",
-}
-
-func TestRegisteredKeys_MatchFrozenBaseline(t *testing.T) {
-	all := compileRealCatalog(t).Definitions()
-	if len(all) == 0 {
-		t.Fatal("no EventKeys registered; the gate scanned nothing")
-	}
-	got := make(map[string]bool, len(all))
-	for _, def := range all {
-		got[def.Key] = true
-	}
-	for _, want := range expectedKeys {
-		if !got[want] {
-			t.Errorf("expected EventKey missing from registry: %s", want)
-		}
-		delete(got, want)
-	}
-	for extra := range got {
-		t.Errorf("EventKey not in frozen baseline (update expectedKeys deliberately): %s", extra)
-	}
-}

events/im/card_action.go

@@ -9,7 +9,6 @@ import (
 	"strings"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // CardActionTriggerOutput is the flattened shape for card.action.trigger.
@@ -36,6 +35,11 @@ type CardActionTriggerOutput struct {
 
 func processCardAction(ctx context.Context, rt event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			Operator struct {
 				OpenID string `json:"open_id"`
@@ -60,7 +64,7 @@ func processCardAction(ctx context.Context, rt event.APIClient, raw *event.RawEv
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload
 	}
 
 	actionValue := marshalToString(envelope.Event.Action.Value)
@@ -68,9 +72,9 @@ func processCardAction(ctx context.Context, rt event.APIClient, raw *event.RawEv
 	options := strings.Join(envelope.Event.Action.Options, ",")
 
 	out := &CardActionTriggerOutput{
-		Type:        raw.EventType,
-		EventID:     raw.EventID,
-		Timestamp:   raw.SourceTime,
+		Type:        envelope.Header.EventType,
+		EventID:     envelope.Header.EventID,
+		Timestamp:   envelope.Header.CreateTime,
 		OperatorID:  envelope.Event.Operator.OpenID,
 		MessageID:   envelope.Event.Context.OpenMessageID,
 		ChatID:      envelope.Event.Context.OpenChatID,

events/im/card_action_test.go

@@ -10,11 +10,10 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 func TestCardActionTriggerRegistered(t *testing.T) {
-	def, ok := lookupCompiledDef(t, "card.action.trigger")
+	def, ok := event.Lookup("card.action.trigger")
 	if !ok {
 		t.Fatal("card.action.trigger should be registered via Keys()")
 	}
@@ -244,11 +243,11 @@ func TestProcessCardAction_MalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processCardAction(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
@@ -416,7 +415,6 @@ func runCardAction(t *testing.T, payload string, rt event.APIClient) CardActionT
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processCardAction(context.Background(), rt, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/im/catalog_helper_test.go

@@ -1,54 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package im
-
-import (
-	"encoding/json"
-	"testing"
-
-	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// fillCanonicalFromHeader copies the payload envelope header metadata onto
-// the RawEvent canonical fields. Process handlers read event_id and
-// create_time from the RawEvent, which the consume pipeline fills from the
-// envelope header before dispatch; tests that hand-build a RawEvent must
-// mirror that so both views agree.
-func fillCanonicalFromHeader(t *testing.T, raw *event.RawEvent) {
-	t.Helper()
-	var envelope struct {
-		Header struct {
-			EventID    string `json:"event_id"`
-			EventType  string `json:"event_type"`
-			CreateTime string `json:"create_time"`
-		} `json:"header"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		t.Fatalf("parse envelope header: %v", err)
-	}
-	raw.EventID = envelope.Header.EventID
-	if envelope.Header.EventType != "" {
-		raw.EventType = envelope.Header.EventType
-	}
-	raw.SourceTime = envelope.Header.CreateTime
-}
-
-// lookupCompiledDef compiles this domain's declarations and resolves one key,
-// exactly as the runtime catalog would for a consumer.
-func lookupCompiledDef(t *testing.T, key string) (*event.KeyDefinition, bool) {
-	t.Helper()
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
-	}
-	entry, ok := snap.Resolve(key)
-	if !ok {
-		return nil, false
-	}
-	return entry.Definition(), true
-}

events/im/message_receive.go

@@ -8,7 +8,6 @@ import (
 	"encoding/json"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 	convertlib "github.com/larksuite/cli/shortcuts/im/convert_lib"
 )
 
@@ -41,6 +40,11 @@ type MentionOutput struct {
 
 func processImMessageReceive(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			Message struct {
 				MessageID   string        `json:"message_id"`
@@ -64,7 +68,7 @@ func processImMessageReceive(_ context.Context, _ event.APIClient, raw *event.Ra
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	msg := envelope.Event.Message
@@ -78,14 +82,14 @@ func processImMessageReceive(_ context.Context, _ event.APIClient, raw *event.Ra
 		})
 	}
 
-	timestamp := raw.SourceTime
+	timestamp := envelope.Header.CreateTime
 	if timestamp == "" {
 		timestamp = msg.CreateTime
 	}
 
 	out := &ImMessageReceiveOutput{
-		Type:        raw.EventType,
-		EventID:     raw.EventID,
+		Type:        envelope.Header.EventType,
+		EventID:     envelope.Header.EventID,
 		Timestamp:   timestamp,
 		ID:          msg.MessageID,
 		MessageID:   msg.MessageID,

events/im/message_receive_test.go

@@ -6,15 +6,22 @@ package im
 import (
 	"context"
 	"encoding/json"
+	"os"
 	"testing"
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
+func TestMain(m *testing.M) {
+	for _, k := range Keys() {
+		event.RegisterKey(k)
+	}
+	os.Exit(m.Run())
+}
+
 func TestIMKeys_ProcessedReceiveRegistered(t *testing.T) {
-	def, ok := lookupCompiledDef(t, "im.message.receive_v1")
+	def, ok := event.Lookup("im.message.receive_v1")
 	if !ok {
 		t.Fatal("im.message.receive_v1 should be registered via Keys()")
 	}
@@ -46,7 +53,7 @@ func TestIMKeys_NativeEventsRegistered(t *testing.T) {
 		"im.chat.disbanded_v1",
 	}
 	for _, k := range want {
-		def, ok := lookupCompiledDef(t, k)
+		def, ok := event.Lookup(k)
 		if !ok {
 			t.Errorf("%s should be registered via Keys()", k)
 			continue
@@ -225,11 +232,11 @@ func TestProcessImMessageReceive_MalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processImMessageReceive(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
@@ -241,7 +248,6 @@ func runReceive(t *testing.T, payload string) ImMessageReceiveOutput {
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processImMessageReceive(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)
@@ -261,7 +267,6 @@ func runReceiveMap(t *testing.T, payload string) map[string]interface{} {
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processImMessageReceive(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/internal/subscribeprep/subscribeprep.go

@@ -1,51 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-// Package subscribeprep provides the shared PreConsume hook for EventKeys
-// whose server-side subscription is a plain event_type register/unregister
-// pair against fixed OAPI paths.
-package subscribeprep
-
-import (
-	"context"
-	"time"
-
-	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/internal/event/processing"
-)
-
-// CleanupTimeout bounds how long the unsubscribe call has to finish during
-// PreConsume cleanup so a stuck OAPI cannot block process shutdown.
-const CleanupTimeout = 5 * time.Second
-
-// Hook returns a PreConsume that subscribes eventType via subscribePath and
-// hands back a cleanup that unsubscribes it via unsubscribePath.
-func Hook(eventType, subscribePath, unsubscribePath string) func(context.Context, processing.APIClient, map[string]string) (func() error, error) {
-	return func(ctx context.Context, rt processing.APIClient, _ map[string]string) (func() error, error) {
-		if rt == nil {
-			return nil, errs.NewInternalError(errs.SubtypeUnknown,
-				"runtime API client is required for pre-consume subscription")
-		}
-		return SubscribeWithCleanup(ctx, rt, eventType, subscribePath, unsubscribePath)
-	}
-}
-
-// SubscribeWithCleanup calls the subscribe OAPI for eventType and returns a
-// cleanup that invokes the matching unsubscribe, bounded by CleanupTimeout.
-// rt must be non-nil; callers that validate their own params (e.g. to build
-// per-resource paths) run those checks first and then delegate here.
-func SubscribeWithCleanup(ctx context.Context, rt processing.APIClient, eventType, subscribePath, unsubscribePath string) (func() error, error) {
-	body := map[string]string{"event_type": eventType}
-	if _, err := rt.CallAPI(ctx, "POST", subscribePath, body); err != nil {
-		return nil, err
-	}
-
-	return func() error {
-		cleanupCtx, cancel := context.WithTimeout(context.Background(), CleanupTimeout)
-		defer cancel()
-		if _, err := rt.CallAPI(cleanupCtx, "POST", unsubscribePath, body); err != nil {
-			return err
-		}
-		return nil
-	}, nil
-}

events/lint_test.go

@@ -9,19 +9,11 @@ import (
 	"testing"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
 	"github.com/larksuite/cli/internal/event/schemas"
 )
 
 func TestAllKeys_FieldOverridePointersResolve(t *testing.T) {
-	snap, err := catalog.Compile(All(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("compile catalog: %v", err)
-	}
-	for _, def := range snap.Definitions() {
+	for _, def := range event.ListAll() {
 		if len(def.Schema.FieldOverrides) == 0 {
 			continue
 		}

events/minutes/catalog_helper_test.go

@@ -1,29 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package minutes
-
-import (
-	"testing"
-
-	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// lookupCompiledDef compiles this domain's declarations and resolves one key,
-// exactly as the runtime catalog would for a consumer.
-func lookupCompiledDef(t *testing.T, key string) (*event.KeyDefinition, bool) {
-	t.Helper()
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
-	}
-	entry, ok := snap.Resolve(key)
-	if !ok {
-		return nil, false
-	}
-	return entry.Definition(), true
-}

events/minutes/minute_generated.go

@@ -10,7 +10,6 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 	"github.com/larksuite/cli/internal/validate"
 )
 
@@ -37,6 +36,11 @@ type MinutesMinuteGeneratedOutput struct {
 
 func processMinutesMinuteGenerated(ctx context.Context, rt event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			MinuteToken  string `json:"minute_token"`
 			MinuteSource struct {
@@ -46,15 +50,18 @@ func processMinutesMinuteGenerated(ctx context.Context, rt event.APIClient, raw
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	out := &MinutesMinuteGeneratedOutput{
-		Type:        raw.EventType,
-		EventID:     raw.EventID,
-		Timestamp:   raw.SourceTime,
+		Type:        envelope.Header.EventType,
+		EventID:     envelope.Header.EventID,
+		Timestamp:   envelope.Header.CreateTime,
 		MinuteToken: envelope.Event.MinuteToken,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	if src := envelope.Event.MinuteSource; src.SourceType != "" || src.SourceEntityID != "" {
 		out.MinuteSource = &MinutesMinuteSourceOutput{
 			SourceType:     src.SourceType,

events/minutes/minute_generated_test.go

@@ -7,12 +7,12 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
+	"os"
 	"reflect"
 	"testing"
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 	"github.com/larksuite/cli/internal/validate"
 )
 
@@ -35,10 +35,17 @@ func assertSubscriptionRequest(t *testing.T, gotBody any, wantEventType string)
 	}
 }
 
+func TestMain(m *testing.M) {
+	for _, k := range Keys() {
+		event.RegisterKey(k)
+	}
+	os.Exit(m.Run())
+}
+
 func TestMinutesKeys_ProcessedMinuteGeneratedRegistered(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, eventTypeMinuteGenerated)
+	def, ok := event.Lookup(eventTypeMinuteGenerated)
 	if !ok {
 		t.Fatalf("%s should be registered via Keys()", eventTypeMinuteGenerated)
 	}
@@ -267,7 +274,7 @@ func TestProcessMinutesMinuteGenerated_EmptyTitleExhaustsRetries(t *testing.T) {
 func TestMinutesMinuteGenerated_PreConsumeSubscriptionLifecycle(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, eventTypeMinuteGenerated)
+	def, ok := event.Lookup(eventTypeMinuteGenerated)
 	if !ok {
 		t.Fatalf("%s should be registered via Keys()", eventTypeMinuteGenerated)
 	}
@@ -319,38 +326,14 @@ func TestProcessMinutesMinuteGenerated_MalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processMinutesMinuteGenerated(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
-// fillCanonicalFromHeader copies the payload envelope header metadata onto
-// the RawEvent canonical fields. Process handlers read event_id and
-// create_time from the RawEvent, which the consume pipeline fills from the
-// envelope header before dispatch; tests that hand-build a RawEvent must
-// mirror that so both views agree.
-func fillCanonicalFromHeader(t *testing.T, raw *event.RawEvent) {
-	t.Helper()
-	var envelope struct {
-		Header struct {
-			EventID    string `json:"event_id"`
-			EventType  string `json:"event_type"`
-			CreateTime string `json:"create_time"`
-		} `json:"header"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		t.Fatalf("parse envelope header: %v", err)
-	}
-	raw.EventID = envelope.Header.EventID
-	if envelope.Header.EventType != "" {
-		raw.EventType = envelope.Header.EventType
-	}
-	raw.SourceTime = envelope.Header.CreateTime
-}
-
 func runMinuteGenerated(t *testing.T, rt event.APIClient, payload string) MinutesMinuteGeneratedOutput {
 	t.Helper()
 	raw := &event.RawEvent{
@@ -358,7 +341,6 @@ func runMinuteGenerated(t *testing.T, rt event.APIClient, payload string) Minute
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processMinutesMinuteGenerated(context.Background(), rt, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/minutes/preconsume.go

@@ -0,0 +1,37 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package minutes
+
+import (
+	"context"
+	"time"
+
+	"github.com/larksuite/cli/errs"
+	"github.com/larksuite/cli/internal/event"
+)
+
+const cleanupTimeout = 5 * time.Second
+
+func subscriptionPreConsume(eventType, subscribePath, unsubscribePath string) func(context.Context, event.APIClient, map[string]string) (func() error, error) {
+	return func(ctx context.Context, rt event.APIClient, _ map[string]string) (func() error, error) {
+		if rt == nil {
+			return nil, errs.NewInternalError(errs.SubtypeUnknown,
+				"runtime API client is required for pre-consume subscription")
+		}
+
+		body := map[string]string{"event_type": eventType}
+		if _, err := rt.CallAPI(ctx, "POST", subscribePath, body); err != nil {
+			return nil, err
+		}
+
+		return func() error {
+			cleanupCtx, cancel := context.WithTimeout(context.Background(), cleanupTimeout)
+			defer cancel()
+			if _, err := rt.CallAPI(cleanupCtx, "POST", unsubscribePath, body); err != nil {
+				return err
+			}
+			return nil
+		}, nil
+	}
+}

events/minutes/register.go

@@ -7,7 +7,6 @@ package minutes
 import (
 	"reflect"
 
-	"github.com/larksuite/cli/events/internal/subscribeprep"
 	"github.com/larksuite/cli/internal/event"
 )
 
@@ -32,7 +31,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(MinutesMinuteGeneratedOutput{})},
 			},
 			Process:    processMinutesMinuteGenerated,
-			PreConsume: subscribeprep.Hook(eventTypeMinuteGenerated, pathMinuteSubscribe, pathMinuteUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeMinuteGenerated, pathMinuteSubscribe, pathMinuteUnsubscribe),
 			Scopes:     []string{"minutes:minutes.basic:read"},
 			AuthTypes: []string{
 				"user",

events/output_baseline_test.go

@@ -1,461 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"bytes"
-	"context"
-	"encoding/json"
-	"flag"
-	"maps"
-	"os"
-	"path/filepath"
-	"sort"
-	"testing"
-	"time"
-
-	event "github.com/larksuite/cli/internal/event"
-)
-
-var updateBaseline = flag.Bool("update-baseline", false,
-	"rewrite testdata/output_baseline.json with the current Processed EventKey outputs")
-
-// TestMain pins the process timezone to UTC before any test runs. Several
-// Process handlers format timestamps in the machine's local timezone
-// (e.g. meeting start/end times, recording event times), so without the pin
-// the snapshot would drift between machines in different timezones.
-func TestMain(m *testing.M) {
-	time.Local = time.UTC
-	os.Exit(m.Run())
-}
-
-const baselineSnapshotPath = "testdata/output_baseline.json"
-
-// wantProcessedKeys freezes how many registered EventKeys define Process
-// (im 2, vc 7, minutes 1, application 1, approval 2). The count assertion
-// keeps this test honest: if a Processed key is added or removed, the covered
-// output surface changed and the baseline would silently widen or narrow
-// without it. Update the count, the fixtures, and the snapshot together,
-// deliberately.
-const wantProcessedKeys = 13
-
-const (
-	baselineEventID    = "evt-baseline-001"
-	baselineCreateTime = "1700000000000" // 2023-11-14T22:13:20Z in milliseconds
-)
-
-// baselineFixture holds the minimal well-formed inputs for one Processed
-// EventKey: the business body placed under "event" in the V2 envelope, plus
-// any extra header fields the handler reads beyond event_id / event_type /
-// create_time. Every fixture must drive Process down its success path — no
-// drop, no malformed-payload passthrough.
-type baselineFixture struct {
-	extraHeader map[string]string
-	eventBody   string
-}
-
-// baselineFixtures maps every Processed EventKey to its synthetic input.
-// Field values are fixed constants so the resulting output is byte-stable.
-var baselineFixtures = map[string]baselineFixture{
-	"application.bot.menu_v6": {
-		extraHeader: map[string]string{
-			"app_id":     "cli-baseline-app",
-			"tenant_key": "tenant-baseline",
-		},
-		// 10-digit seconds timestamp: the handler normalizes it to milliseconds.
-		eventBody: `{
-			"event_key": "baseline_menu_key",
-			"timestamp": 1700000000,
-			"operator": {
-				"operator_id": {
-					"open_id": "ou-baseline-operator",
-					"union_id": "on-baseline-operator",
-					"user_id": "user-baseline-operator"
-				},
-				"operator_name": "Baseline Operator"
-			}
-		}`,
-	},
-	"approval.instance.status_changed_v4": {
-		eventBody: `{
-			"approval_code": "approval-code-baseline",
-			"instance_code": "instance-code-baseline",
-			"external_id": "external-id-baseline",
-			"status": "APPROVED",
-			"operate_time": "1700000000000",
-			"start_user": {
-				"open_id": "ou-baseline-starter",
-				"union_id": "on-baseline-starter",
-				"user_id": "user-baseline-starter"
-			}
-		}`,
-	},
-	"approval.task.status_changed_v4": {
-		eventBody: `{
-			"approval_code": "approval-code-baseline",
-			"instance_code": "instance-code-baseline",
-			"task_id": "task-id-baseline",
-			"external_id": "external-id-baseline",
-			"task_external_id": "task-external-id-baseline",
-			"status": "APPROVED",
-			"operate_time": "1700000000000",
-			"assigned_user": {
-				"open_id": "ou-baseline-assignee",
-				"union_id": "on-baseline-assignee",
-				"user_id": "user-baseline-assignee"
-			}
-		}`,
-	},
-	// The card handler fetches the card content through the API client using
-	// context.open_message_id; the fake client below serves that request.
-	"card.action.trigger": {
-		eventBody: `{
-			"operator": {"open_id": "ou-baseline-operator"},
-			"token": "card-token-baseline",
-			"host": "im_message",
-			"action": {
-				"tag": "button",
-				"value": {"key": "baseline"},
-				"name": "baseline_button",
-				"form_value": {"field": "value"},
-				"input_value": "baseline input",
-				"option": "opt-1",
-				"options": ["opt-1", "opt-2"],
-				"checked": true,
-				"timezone": "Asia/Shanghai"
-			},
-			"context": {
-				"open_message_id": "om-baseline-card",
-				"open_chat_id": "oc-baseline-chat"
-			}
-		}`,
-	},
-	// update_time differs from create_time so the handler emits both; the
-	// mention placeholder in content exercises mention rendering.
-	"im.message.receive_v1": {
-		eventBody: `{
-			"sender": {
-				"sender_type": "user",
-				"sender_id": {"open_id": "ou-baseline-sender"}
-			},
-			"message": {
-				"message_id": "om-baseline-msg",
-				"root_id": "om-baseline-root",
-				"parent_id": "om-baseline-parent",
-				"thread_id": "omt-baseline-thread",
-				"chat_id": "oc-baseline-chat",
-				"chat_type": "p2p",
-				"message_type": "text",
-				"create_time": "1699999999000",
-				"update_time": "1700000000500",
-				"content": "{\"text\":\"hello @_user_1\"}",
-				"mentions": [
-					{
-						"key": "@_user_1",
-						"id": {"open_id": "ou-baseline-mention"},
-						"name": "Baseline User"
-					}
-				]
-			}
-		}`,
-	},
-	// The minutes handler enriches the output with the minute title via the
-	// API client; the fake client answers with a non-empty title on the first
-	// call so no retry attempt is made.
-	"minutes.minute.generated_v1": {
-		eventBody: `{
-			"minute_token": "minute-token-baseline",
-			"minute_source": {
-				"source_type": "meeting",
-				"source_entity_id": "meeting-entity-baseline"
-			}
-		}`,
-	},
-	"vc.meeting.participant_meeting_started_v1": {
-		eventBody: `{
-			"meeting": {
-				"id": "meeting-id-baseline",
-				"topic": "Baseline meeting",
-				"meeting_no": "123456789",
-				"start_time": "1700000000",
-				"calendar_event_id": "calendar-event-baseline"
-			}
-		}`,
-	},
-	"vc.meeting.participant_meeting_joined_v1": {
-		eventBody: `{
-			"meeting": {
-				"id": "meeting-id-baseline",
-				"topic": "Baseline meeting",
-				"meeting_no": "123456789",
-				"start_time": "1700000000",
-				"calendar_event_id": "calendar-event-baseline"
-			}
-		}`,
-	},
-	"vc.meeting.participant_meeting_ended_v1": {
-		eventBody: `{
-			"meeting": {
-				"id": "meeting-id-baseline",
-				"topic": "Baseline meeting",
-				"meeting_no": "123456789",
-				"start_time": "1700000000",
-				"end_time": "1700000600",
-				"calendar_event_id": "calendar-event-baseline"
-			}
-		}`,
-	},
-	// The note handler enriches the output with document tokens via the API
-	// client; the fake client answers with both artifacts on the first call
-	// so no retry attempt is made.
-	"vc.note.generated_v1": {
-		eventBody: `{"note_id": "note-id-baseline"}`,
-	},
-	// Recording handlers only emit events whose source is recording_bean;
-	// anything else is dropped, which would break the success-path contract.
-	"vc.recording.recording_started_v1": {
-		eventBody: `{
-			"unique_key": "recording-key-baseline",
-			"source": "recording_bean"
-		}`,
-	},
-	"vc.recording.recording_transcript_generated_v1": {
-		eventBody: `{
-			"unique_key": "recording-key-baseline",
-			"source": "recording_bean",
-			"transcript_items": [
-				{
-					"speaker": {"user_name": "Baseline Speaker"},
-					"text": "baseline transcript text",
-					"start_time_ms": "1700000000000",
-					"end_time_ms": "1700000001000",
-					"sentence_id": "sentence-baseline-1"
-				}
-			]
-		}`,
-	},
-	"vc.recording.recording_ended_v1": {
-		eventBody: `{
-			"unique_key": "recording-key-baseline",
-			"source": "recording_bean"
-		}`,
-	},
-}
-
-// baselineAPIResponses maps request paths to canned success responses for the
-// handlers that call the API during Process. Every response satisfies the
-// handler on the first call, so retry loops never engage and no real network
-// or credentials are involved.
-var baselineAPIResponses = map[string]string{
-	"/open-apis/im/v1/messages/om-baseline-card?card_msg_content_type=user_card_content": `{
-		"code": 0,
-		"msg": "success",
-		"data": {
-			"items": [
-				{"body": {"content": "{\"header\":{\"title\":{\"tag\":\"plain_text\",\"content\":\"Baseline card\"}}}"}}
-			]
-		}
-	}`,
-	"/open-apis/vc/v1/notes/note-id-baseline": `{
-		"code": 0,
-		"msg": "success",
-		"data": {
-			"note": {
-				"artifacts": [
-					{"artifact_type": 1, "doc_token": "note-doc-token-baseline"},
-					{"artifact_type": 2, "doc_token": "verbatim-doc-token-baseline"}
-				],
-				"note_source": {
-					"source_type": "meeting",
-					"source_entity_id": "meeting-entity-baseline"
-				}
-			}
-		}
-	}`,
-	"/open-apis/minutes/v1/minutes/minute-token-baseline": `{
-		"code": 0,
-		"msg": "success",
-		"data": {
-			"minute": {"title": "Baseline minute title"}
-		}
-	}`,
-}
-
-// baselineAPIClient serves the canned responses above. An unexpected request
-// path fails the test immediately instead of returning an error, because
-// several handlers swallow API errors (or retry with delays) and would
-// silently produce a degraded output that gets frozen into the baseline.
-type baselineAPIClient struct {
-	t *testing.T
-}
-
-func (c *baselineAPIClient) CallAPI(_ context.Context, method, path string, _ any) (json.RawMessage, error) {
-	c.t.Helper()
-	resp, ok := baselineAPIResponses[path]
-	if !ok {
-		c.t.Fatalf("unexpected API call during Process: %s %s — add a canned response to baselineAPIResponses", method, path)
-	}
-	return json.RawMessage(resp), nil
-}
-
-// TestProcessedOutputBaseline runs every Processed EventKey against a fixed
-// well-formed synthetic payload and compares the outputs with the frozen
-// snapshot in testdata/output_baseline.json. Any change to what a Processed
-// key writes to stdout for a well-formed event shows up here as a named,
-// per-key diff. Run with -update-baseline to accept an intentional change.
-func TestProcessedOutputBaseline(t *testing.T) {
-	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
-
-	rt := &baselineAPIClient{t: t}
-	got := map[string]json.RawMessage{}
-	seenFixtures := map[string]bool{}
-
-	for _, def := range compileRealCatalog(t).Definitions() {
-		if def.Process == nil {
-			continue
-		}
-		fx, ok := baselineFixtures[def.Key]
-		if !ok {
-			t.Fatalf("Processed EventKey %q has no baseline fixture; add one to baselineFixtures, bump wantProcessedKeys, and regenerate with -update-baseline", def.Key)
-		}
-		seenFixtures[def.Key] = true
-
-		payload := buildBaselineEnvelope(t, def.EventType, fx)
-		// The canonical fields mirror the synthetic envelope header exactly,
-		// including any extra header fields, just as the consume pipeline
-		// guarantees for real events before Process runs.
-		raw := &event.RawEvent{
-			EventID:    baselineEventID,
-			EventType:  def.EventType,
-			SourceTime: baselineCreateTime,
-			AppID:      fx.extraHeader["app_id"],
-			TenantKey:  fx.extraHeader["tenant_key"],
-			Payload:    payload,
-			Timestamp:  time.Unix(1700000000, 0).UTC(),
-		}
-
-		out, err := def.Process(context.Background(), rt, raw, nil)
-		if err != nil {
-			t.Fatalf("%s: Process returned error on well-formed payload: %v", def.Key, err)
-		}
-		if out == nil {
-			t.Fatalf("%s: Process dropped a well-formed payload; the fixture must exercise the success path", def.Key)
-		}
-		if bytes.Equal(compactJSON(t, def.Key, out), compactJSON(t, def.Key, payload)) {
-			t.Fatalf("%s: Process returned the input unchanged; the fixture must exercise the success path, not the malformed-payload passthrough", def.Key)
-		}
-		got[def.Key] = out
-	}
-
-	if len(got) != wantProcessedKeys {
-		t.Fatalf("processed %d EventKeys, want exactly %d; a Processed key was added or removed — update baselineFixtures, wantProcessedKeys, and the snapshot together (keys run: %v)",
-			len(got), wantProcessedKeys, sortedKeys(got))
-	}
-	for key := range baselineFixtures {
-		if !seenFixtures[key] {
-			t.Fatalf("baseline fixture %q matches no registered Processed EventKey; remove it or fix the key name", key)
-		}
-	}
-
-	if *updateBaseline {
-		writeBaselineSnapshot(t, got)
-		return
-	}
-	compareBaselineSnapshot(t, got)
-}
-
-// buildBaselineEnvelope wraps a fixture body in the standard V2 event
-// envelope with fixed header values.
-func buildBaselineEnvelope(t *testing.T, eventType string, fx baselineFixture) json.RawMessage {
-	t.Helper()
-	header := map[string]string{
-		"event_id":    baselineEventID,
-		"event_type":  eventType,
-		"create_time": baselineCreateTime,
-	}
-	maps.Copy(header, fx.extraHeader)
-	headerJSON, err := json.Marshal(header)
-	if err != nil {
-		t.Fatalf("marshal envelope header: %v", err)
-	}
-	envelope := map[string]json.RawMessage{
-		"schema": json.RawMessage(`"2.0"`),
-		"header": headerJSON,
-		"event":  json.RawMessage(fx.eventBody),
-	}
-	payload, err := json.Marshal(envelope)
-	if err != nil {
-		t.Fatalf("marshal envelope for %s: %v", eventType, err)
-	}
-	return payload
-}
-
-func writeBaselineSnapshot(t *testing.T, got map[string]json.RawMessage) {
-	t.Helper()
-	// MarshalIndent sorts map keys, so the snapshot is deterministic.
-	data, err := json.MarshalIndent(got, "", "  ")
-	if err != nil {
-		t.Fatalf("marshal snapshot: %v", err)
-	}
-	data = append(data, '\n')
-	if err := os.MkdirAll(filepath.Dir(baselineSnapshotPath), 0o755); err != nil {
-		t.Fatalf("create testdata dir: %v", err)
-	}
-	if err := os.WriteFile(baselineSnapshotPath, data, 0o644); err != nil {
-		t.Fatalf("write snapshot: %v", err)
-	}
-	t.Logf("baseline snapshot rewritten: %s (%d keys)", baselineSnapshotPath, len(got))
-}
-
-func compareBaselineSnapshot(t *testing.T, got map[string]json.RawMessage) {
-	t.Helper()
-	data, err := os.ReadFile(baselineSnapshotPath)
-	if os.IsNotExist(err) {
-		t.Fatalf("baseline snapshot %s not found; generate it with: go test ./events/ -run TestProcessedOutput -update-baseline", baselineSnapshotPath)
-	}
-	if err != nil {
-		t.Fatalf("read snapshot: %v", err)
-	}
-	var want map[string]json.RawMessage
-	if err := json.Unmarshal(data, &want); err != nil {
-		t.Fatalf("snapshot %s is not valid JSON: %v", baselineSnapshotPath, err)
-	}
-
-	for _, key := range sortedKeys(want) {
-		if _, ok := got[key]; !ok {
-			t.Errorf("%s: present in snapshot but produced no output this run; if the key was removed on purpose, regenerate with -update-baseline", key)
-		}
-	}
-	for _, key := range sortedKeys(got) {
-		wantOut, ok := want[key]
-		if !ok {
-			t.Errorf("%s: produced output but missing from snapshot; regenerate with -update-baseline", key)
-			continue
-		}
-		gotC := compactJSON(t, key, got[key])
-		wantC := compactJSON(t, key, wantOut)
-		if !bytes.Equal(gotC, wantC) {
-			t.Errorf("%s: Processed output drifted from baseline\n  got:  %s\n  want: %s\nIf this change is intentional, regenerate with -update-baseline", key, gotC, wantC)
-		}
-	}
-}
-
-// compactJSON canonicalizes whitespace so comparisons are content-only.
-func compactJSON(t *testing.T, key string, raw json.RawMessage) []byte {
-	t.Helper()
-	var buf bytes.Buffer
-	if err := json.Compact(&buf, raw); err != nil {
-		t.Fatalf("%s: output is not valid JSON: %v\nraw=%s", key, err, string(raw))
-	}
-	return buf.Bytes()
-}
-
-func sortedKeys(m map[string]json.RawMessage) []string {
-	keys := make([]string, 0, len(m))
-	for k := range m {
-		keys = append(keys, k)
-	}
-	sort.Strings(keys)
-	return keys
-}

events/register.go

@@ -1,9 +1,7 @@
 // Copyright (c) 2026 Lark Technologies Pte. Ltd.
 // SPDX-License-Identifier: MIT
 
-// Package events aggregates the domain EventKey declarations. All returns
-// them explicitly — whoever needs a catalog compiles one; nothing registers
-// itself through import side effects.
+// Package events wires domain EventKey definitions into the global registry. Blank-import to populate.
 package events
 
 import (
@@ -14,14 +12,12 @@ import (
 	"github.com/larksuite/cli/events/task"
 	"github.com/larksuite/cli/events/vc"
 	"github.com/larksuite/cli/events/whiteboard"
-	"github.com/larksuite/cli/internal/event/catalog"
+	"github.com/larksuite/cli/internal/event"
 )
 
-// All returns every domain's declarations, ready for catalog.Compile.
 // Mail is intentionally omitted in this phase.
-func All() []catalog.KeyDefinition {
-	var all []catalog.KeyDefinition
-	for _, keys := range [][]catalog.KeyDefinition{
+func init() {
+	all := [][]event.KeyDefinition{
 		application.Keys(),
 		approval.Keys(),
 		im.Keys(),
@@ -29,8 +25,10 @@ func All() []catalog.KeyDefinition {
 		task.Keys(),
 		vc.Keys(),
 		whiteboard.Keys(),
-	} {
-		all = append(all, keys...)
 	}
-	return all
+	for _, keys := range all {
+		for _, k := range keys {
+			event.RegisterKey(k)
+		}
+	}
 }

events/schema_closure_test.go

@@ -1,75 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"context"
-	"encoding/json"
-	"errors"
-	"testing"
-	"time"
-
-	event "github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
-)
-
-// closureAPIClient answers any API call with a benign error: a handler facing
-// a malformed payload must decide to drop before it ever needs the API.
-type closureAPIClient struct{}
-
-func (closureAPIClient) CallAPI(context.Context, string, string, any) (json.RawMessage, error) {
-	return nil, errors.New("no API access for malformed input")
-}
-
-// Every Processed EventKey declares an output schema; its stdout must stay
-// inside that schema. A payload that cannot be decoded therefore has exactly
-// one legal outcome: a malformed drop. Passing the raw envelope through would
-// hand consumers a shape the schema never described.
-//
-// Native keys (Process == nil) are exempt by contract: their declared output
-// is the raw envelope itself.
-func TestAllKeys_MalformedPayloadStaysSchemaClosed(t *testing.T) {
-	const wantProcessedKeys = 13
-
-	processed := 0
-	for _, def := range compileRealCatalog(t).Definitions() {
-		if def.Process == nil {
-			continue
-		}
-		processed++
-		out, err := safeProcess(t, def, json.RawMessage(`this is definitely not valid json {{{`))
-		if out != nil {
-			t.Errorf("%s: malformed payload produced stdout output; it must be dropped", def.Key)
-		}
-		if !processing.IsDropMalformed(err) {
-			t.Errorf("%s: malformed payload must be dropped with a malformed marker, got err=%v", def.Key, err)
-		}
-	}
-	if processed == 0 {
-		t.Fatal("no processed keys were exercised; the gate scanned nothing")
-	}
-	if processed != wantProcessedKeys {
-		t.Fatalf("exercised %d processed keys, want exactly %d; update the count when keys are deliberately added or removed", processed, wantProcessedKeys)
-	}
-}
-
-// safeProcess isolates a panicking handler to a per-key finding instead of
-// aborting the whole gate: a handler that dereferences before decoding is a
-// bug in that key, not a reason to stop scanning the rest.
-func safeProcess(t *testing.T, def *event.KeyDefinition, payload json.RawMessage) (out json.RawMessage, err error) {
-	t.Helper()
-	defer func() {
-		if r := recover(); r != nil {
-			t.Errorf("%s: Process panicked on malformed payload: %v", def.Key, r)
-			out, err = nil, nil
-		}
-	}()
-	raw := &event.RawEvent{
-		EventID:   "evt-closure-1",
-		EventType: def.EventType,
-		Payload:   payload,
-		Timestamp: time.Unix(0, 0),
-	}
-	return def.Process(context.Background(), closureAPIClient{}, raw, map[string]string{})
-}

events/schema_instance_test.go

@@ -1,259 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package events_test
-
-import (
-	"bytes"
-	"encoding/json"
-	"fmt"
-	"os"
-	"sort"
-	"strconv"
-	"testing"
-
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// The output baseline freezes what every Processed key writes to stdout; the
-// compiled catalog promises a schema for the same bytes. This test closes the
-// loop between the two: every frozen output must be an instance of its key's
-// resolved schema, so a schema and its real output can never drift apart with
-// both sides individually green.
-//
-// The repository deliberately carries no JSON Schema validation dependency,
-// so validation is done by a minimal in-repo checker that covers exactly the
-// subset the catalog compiler emits (see validateValue). Any schema construct
-// outside that subset is a loud failure, never a silent pass.
-func TestProcessedBaselineOutputs_ConformToDeclaredSchemas(t *testing.T) {
-	snap := compileRealCatalog(t)
-	baseline := readBaselineSnapshot(t)
-
-	validated := 0
-	for _, entry := range snap.Entries() {
-		out := entry.Output()
-		if out.Mode != catalog.OutputProcessed {
-			continue
-		}
-		key := entry.Descriptor().Key
-		frozen, ok := baseline[key]
-		if !ok {
-			t.Errorf("%s: Processed key has no entry in %s; regenerate the baseline first", key, baselineSnapshotPath)
-			continue
-		}
-		schema := decodeSchemaNode(t, key, out.SchemaJSON)
-		instance := decodeInstance(t, key, frozen)
-		for _, problem := range validateValue("$", schema, instance) {
-			t.Errorf("%s: frozen output violates the declared schema: %s", key, problem)
-		}
-		validated++
-	}
-
-	// Idle detection, both directions: every Processed key was checked
-	// against a baseline entry, and no baseline entry escaped the check.
-	if validated == 0 {
-		t.Fatal("no Processed key was validated; the gate scanned nothing")
-	}
-	if validated != len(baseline) {
-		t.Fatalf("validated %d Processed keys but the baseline holds %d entries — a baseline entry matches no compiled Processed key (keys: %v)",
-			validated, len(baseline), sortedKeys(baseline))
-	}
-}
-
-// The validator itself must bite: an output tampered with in memory — an
-// undeclared field, a primitive type flip — has to produce findings,
-// otherwise a green conformance run proves nothing. The baseline file is
-// never modified.
-func TestSchemaInstanceValidator_BitesOnTamperedOutput(t *testing.T) {
-	const key = "im.message.receive_v1"
-	snap := compileRealCatalog(t)
-	entry, ok := snap.Resolve(key)
-	if !ok {
-		t.Fatalf("key %s is gone from the catalog; pick another Processed key for this self-check", key)
-	}
-	baseline := readBaselineSnapshot(t)
-	frozen, ok := baseline[key]
-	if !ok {
-		t.Fatalf("key %s has no baseline entry; the self-check needs a real frozen output", key)
-	}
-	schema := decodeSchemaNode(t, key, entry.Output().SchemaJSON)
-
-	// Control: the untampered output is conformant, so any finding below is
-	// caused by the tampering alone.
-	if problems := validateValue("$", schema, decodeInstance(t, key, frozen)); len(problems) != 0 {
-		t.Fatalf("control failed: the untampered output already has findings: %v", problems)
-	}
-
-	tampered, ok := decodeInstance(t, key, frozen).(map[string]any)
-	if !ok {
-		t.Fatalf("baseline output for %s is not a JSON object", key)
-	}
-	tampered["field_the_schema_never_declared"] = "smuggled"
-	if problems := validateValue("$", schema, tampered); len(problems) != 1 {
-		t.Errorf("an undeclared field must produce exactly one finding, got: %v", problems)
-	}
-
-	flipped, _ := decodeInstance(t, key, frozen).(map[string]any)
-	flipped["message_id"] = true // declared as a string
-	if problems := validateValue("$", schema, flipped); len(problems) != 1 {
-		t.Errorf("a primitive type flip must produce exactly one finding, got: %v", problems)
-	}
-}
-
-func readBaselineSnapshot(t *testing.T) map[string]json.RawMessage {
-	t.Helper()
-	data, err := os.ReadFile(baselineSnapshotPath)
-	if err != nil {
-		t.Fatalf("read %s: %v", baselineSnapshotPath, err)
-	}
-	var out map[string]json.RawMessage
-	if err := json.Unmarshal(data, &out); err != nil {
-		t.Fatalf("%s is not valid JSON: %v", baselineSnapshotPath, err)
-	}
-	return out
-}
-
-func decodeSchemaNode(t *testing.T, key string, raw json.RawMessage) map[string]any {
-	t.Helper()
-	var schema map[string]any
-	if err := json.Unmarshal(raw, &schema); err != nil {
-		t.Fatalf("%s: resolved schema is not a JSON object: %v", key, err)
-	}
-	return schema
-}
-
-// decodeInstance parses a frozen output with UseNumber so integer/number
-// checks see the literal digits instead of a lossy float64.
-func decodeInstance(t *testing.T, key string, raw json.RawMessage) any {
-	t.Helper()
-	dec := json.NewDecoder(bytes.NewReader(raw))
-	dec.UseNumber()
-	var v any
-	if err := dec.Decode(&v); err != nil {
-		t.Fatalf("%s: baseline output is not valid JSON: %v", key, err)
-	}
-	return v
-}
-
-// validateValue checks one instance value against one schema node and returns
-// the problems found. It implements only the subset the catalog compiler can
-// emit (schemas.FromType plus raw declarations shaped the same way):
-//
-//   - type object with properties: every instance field must be declared in
-//     properties and conform to its node; undeclared fields are errors.
-//     Absent declared fields are legal (handlers omit empty members).
-//   - type string / integer / number / boolean: the JSON value kind must
-//     match.
-//   - type array with items: every element must conform to items.
-//
-// description/format/enum annotations are metadata, not instance constraints
-// here. Any construct outside the subset — a missing or unknown type, an
-// object without properties, additionalProperties, an array without items —
-// is reported as a problem so the validator can only be extended
-// deliberately, never bypassed by a schema it does not understand.
-func validateValue(path string, schema map[string]any, value any) []string {
-	typ, ok := schema["type"].(string)
-	if !ok {
-		return []string{fmt.Sprintf("%s: schema node has no \"type\"; outside the minimal validator subset, extend the validator deliberately", path)}
-	}
-
-	switch typ {
-	case "object":
-		obj, ok := value.(map[string]any)
-		if !ok {
-			return []string{fmt.Sprintf("%s: schema declares object, output has %s", path, jsonKind(value))}
-		}
-		if _, has := schema["additionalProperties"]; has {
-			return []string{fmt.Sprintf("%s: schema uses additionalProperties; outside the minimal validator subset, extend the validator deliberately", path)}
-		}
-		props, ok := schema["properties"].(map[string]any)
-		if !ok {
-			return []string{fmt.Sprintf("%s: object schema without properties; outside the minimal validator subset, extend the validator deliberately", path)}
-		}
-		var problems []string
-		for _, field := range sortedFieldNames(obj) {
-			fieldPath := path + "." + field
-			node, declared := props[field]
-			if !declared {
-				problems = append(problems, fmt.Sprintf("%s: field is not declared in the schema properties", fieldPath))
-				continue
-			}
-			nodeObj, ok := node.(map[string]any)
-			if !ok {
-				problems = append(problems, fmt.Sprintf("%s: schema property is not an object", fieldPath))
-				continue
-			}
-			problems = append(problems, validateValue(fieldPath, nodeObj, obj[field])...)
-		}
-		return problems
-
-	case "string":
-		if _, ok := value.(string); !ok {
-			return []string{fmt.Sprintf("%s: schema declares string, output has %s", path, jsonKind(value))}
-		}
-	case "boolean":
-		if _, ok := value.(bool); !ok {
-			return []string{fmt.Sprintf("%s: schema declares boolean, output has %s", path, jsonKind(value))}
-		}
-	case "integer":
-		num, ok := value.(json.Number)
-		if !ok {
-			return []string{fmt.Sprintf("%s: schema declares integer, output has %s", path, jsonKind(value))}
-		}
-		if _, err := strconv.ParseInt(num.String(), 10, 64); err != nil {
-			return []string{fmt.Sprintf("%s: schema declares integer, output has non-integer number %s", path, num)}
-		}
-	case "number":
-		if _, ok := value.(json.Number); !ok {
-			return []string{fmt.Sprintf("%s: schema declares number, output has %s", path, jsonKind(value))}
-		}
-
-	case "array":
-		arr, ok := value.([]any)
-		if !ok {
-			return []string{fmt.Sprintf("%s: schema declares array, output has %s", path, jsonKind(value))}
-		}
-		items, ok := schema["items"].(map[string]any)
-		if !ok {
-			return []string{fmt.Sprintf("%s: array schema without items; outside the minimal validator subset, extend the validator deliberately", path)}
-		}
-		var problems []string
-		for i, elem := range arr {
-			problems = append(problems, validateValue(fmt.Sprintf("%s[%d]", path, i), items, elem)...)
-		}
-		return problems
-
-	default:
-		return []string{fmt.Sprintf("%s: schema type %q; outside the minimal validator subset, extend the validator deliberately", path, typ)}
-	}
-	return nil
-}
-
-// jsonKind names a decoded JSON value's kind for problem messages.
-func jsonKind(v any) string {
-	switch v.(type) {
-	case nil:
-		return "null"
-	case bool:
-		return "boolean"
-	case string:
-		return "string"
-	case json.Number:
-		return "number"
-	case []any:
-		return "array"
-	case map[string]any:
-		return "object"
-	default:
-		return fmt.Sprintf("%T", v)
-	}
-}
-
-func sortedFieldNames(obj map[string]any) []string {
-	names := make([]string, 0, len(obj))
-	for name := range obj {
-		names = append(names, name)
-	}
-	sort.Strings(names)
-	return names
-}

events/task/register_test.go

@@ -8,7 +8,7 @@ import (
 	"reflect"
 	"testing"
 
-	"github.com/larksuite/cli/internal/event/catalog"
+	"github.com/larksuite/cli/internal/event"
 	"github.com/larksuite/cli/internal/event/schemas"
 )
 
@@ -83,14 +83,13 @@ func TestTaskUpdateUserAccessSchemaAnnotations(t *testing.T) {
 
 func TestTaskUpdateUserAccessRegistersCleanly(t *testing.T) {
 	const key = eventTypeTaskUpdateUserAccessV2
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
+	event.UnregisterKeyForTest(key)
+	t.Cleanup(func() { event.UnregisterKeyForTest(key) })
+
+	for _, def := range Keys() {
+		event.RegisterKey(def)
 	}
-	if _, ok := snap.Resolve(key); !ok {
-		t.Fatalf("snap.Resolve(%q): key missing from compiled catalog", key)
+	if _, ok := event.Lookup(key); !ok {
+		t.Fatalf("event.Lookup(%q) not registered", key)
 	}
 }

events/testdata/output_baseline.json

@@ -1,177 +0,0 @@
-{
-  "application.bot.menu_v6": {
-    "type": "application.bot.menu_v6",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "app_id": "cli-baseline-app",
-    "tenant_key": "tenant-baseline",
-    "event_key": "baseline_menu_key",
-    "menu_timestamp": "1700000000000",
-    "operator_id": "ou-baseline-operator",
-    "operator_open_id": "ou-baseline-operator",
-    "operator_union_id": "on-baseline-operator",
-    "operator_user_id": "user-baseline-operator",
-    "operator_name": "Baseline Operator"
-  },
-  "approval.instance.status_changed_v4": {
-    "type": "approval.instance.status_changed_v4",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "approval_code": "approval-code-baseline",
-    "instance_code": "instance-code-baseline",
-    "external_id": "external-id-baseline",
-    "status": "APPROVED",
-    "operate_time": "1700000000000",
-    "start_user": {
-      "open_id": "ou-baseline-starter",
-      "union_id": "on-baseline-starter",
-      "user_id": "user-baseline-starter"
-    }
-  },
-  "approval.task.status_changed_v4": {
-    "type": "approval.task.status_changed_v4",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "approval_code": "approval-code-baseline",
-    "instance_code": "instance-code-baseline",
-    "task_id": "task-id-baseline",
-    "external_id": "external-id-baseline",
-    "task_external_id": "task-external-id-baseline",
-    "assigned_user": {
-      "open_id": "ou-baseline-assignee",
-      "union_id": "on-baseline-assignee",
-      "user_id": "user-baseline-assignee"
-    },
-    "status": "APPROVED",
-    "operate_time": "1700000000000"
-  },
-  "card.action.trigger": {
-    "type": "card.action.trigger",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "operator_id": "ou-baseline-operator",
-    "message_id": "om-baseline-card",
-    "chat_id": "oc-baseline-chat",
-    "host": "im_message",
-    "token": "card-token-baseline",
-    "action_tag": "button",
-    "action_value": "{\"key\":\"baseline\"}",
-    "action_name": "baseline_button",
-    "form_value": "{\"field\":\"value\"}",
-    "input_value": "baseline input",
-    "option": "opt-1",
-    "options": "opt-1,opt-2",
-    "checked": true,
-    "timezone": "Asia/Shanghai",
-    "card_content": "{\"header\":{\"title\":{\"tag\":\"plain_text\",\"content\":\"Baseline card\"}}}"
-  },
-  "im.message.receive_v1": {
-    "type": "im.message.receive_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "id": "om-baseline-msg",
-    "message_id": "om-baseline-msg",
-    "create_time": "1699999999000",
-    "update_time": "1700000000500",
-    "chat_id": "oc-baseline-chat",
-    "chat_type": "p2p",
-    "message_type": "text",
-    "sender_id": "ou-baseline-sender",
-    "sender_type": "user",
-    "root_id": "om-baseline-root",
-    "thread_id": "omt-baseline-thread",
-    "reply_to": "om-baseline-parent",
-    "content": "hello @Baseline User",
-    "mentions": [
-      {
-        "key": "@_user_1",
-        "id": "ou-baseline-mention",
-        "name": "Baseline User"
-      }
-    ]
-  },
-  "minutes.minute.generated_v1": {
-    "type": "minutes.minute.generated_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "minute_token": "minute-token-baseline",
-    "title": "Baseline minute title",
-    "minute_source": {
-      "source_type": "meeting",
-      "source_entity_id": "meeting-entity-baseline"
-    }
-  },
-  "vc.meeting.participant_meeting_ended_v1": {
-    "type": "vc.meeting.participant_meeting_ended_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "meeting_id": "meeting-id-baseline",
-    "topic": "Baseline meeting",
-    "meeting_no": "123456789",
-    "start_time": "2023-11-14T22:13:20Z",
-    "end_time": "2023-11-14T22:23:20Z",
-    "calendar_event_id": "calendar-event-baseline"
-  },
-  "vc.meeting.participant_meeting_joined_v1": {
-    "type": "vc.meeting.participant_meeting_joined_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "meeting_id": "meeting-id-baseline",
-    "topic": "Baseline meeting",
-    "meeting_no": "123456789",
-    "start_time": "2023-11-14T22:13:20Z",
-    "calendar_event_id": "calendar-event-baseline"
-  },
-  "vc.meeting.participant_meeting_started_v1": {
-    "type": "vc.meeting.participant_meeting_started_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "meeting_id": "meeting-id-baseline",
-    "topic": "Baseline meeting",
-    "meeting_no": "123456789",
-    "start_time": "2023-11-14T22:13:20Z",
-    "calendar_event_id": "calendar-event-baseline"
-  },
-  "vc.note.generated_v1": {
-    "type": "vc.note.generated_v1",
-    "event_id": "evt-baseline-001",
-    "timestamp": "1700000000000",
-    "note_id": "note-id-baseline",
-    "note_token": "note-doc-token-baseline",
-    "verbatim_token": "verbatim-doc-token-baseline",
-    "note_source": {
-      "source_type": "meeting",
-      "source_entity_id": "meeting-entity-baseline"
-    }
-  },
-  "vc.recording.recording_ended_v1": {
-    "type": "vc.recording.recording_ended_v1",
-    "event_id": "evt-baseline-001",
-    "event_time": "2023-11-14T22:13:20Z",
-    "unique_key": "recording-key-baseline",
-    "source": "recording_bean"
-  },
-  "vc.recording.recording_started_v1": {
-    "type": "vc.recording.recording_started_v1",
-    "event_id": "evt-baseline-001",
-    "event_time": "2023-11-14T22:13:20Z",
-    "unique_key": "recording-key-baseline",
-    "source": "recording_bean"
-  },
-  "vc.recording.recording_transcript_generated_v1": {
-    "type": "vc.recording.recording_transcript_generated_v1",
-    "event_id": "evt-baseline-001",
-    "event_time": "2023-11-14T22:13:20Z",
-    "unique_key": "recording-key-baseline",
-    "source": "recording_bean",
-    "transcript_items": [
-      {
-        "speaker_name": "Baseline Speaker",
-        "text": "baseline transcript text",
-        "start_time": "2023-11-14T22:13:20Z",
-        "end_time": "2023-11-14T22:13:21Z",
-        "sentence_id": "sentence-baseline-1"
-      }
-    ]
-  }
-}

events/vc/catalog_helper_test.go

@@ -1,29 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"testing"
-
-	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/catalog"
-)
-
-// lookupCompiledDef compiles this domain's declarations and resolves one key,
-// exactly as the runtime catalog would for a consumer.
-func lookupCompiledDef(t *testing.T, key string) (*event.KeyDefinition, bool) {
-	t.Helper()
-	snap, err := catalog.Compile(Keys(), catalog.StrategyRefs{
-		catalog.StrategyNone,
-		catalog.StrategyLegacyPreConsume,
-	})
-	if err != nil {
-		t.Fatalf("catalog.Compile(Keys()): %v", err)
-	}
-	entry, ok := snap.Resolve(key)
-	if !ok {
-		return nil, false
-	}
-	return entry.Definition(), true
-}

events/vc/internal_helpers.go

@@ -1,62 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package vc
-
-import (
-	"encoding/json"
-	"strconv"
-	"time"
-
-	"github.com/larksuite/cli/internal/event"
-)
-
-// recordingBeanSource is the only recording source the vc.recording.* keys
-// emit; events carrying any other source are silently filtered out.
-const recordingBeanSource = "recording_bean"
-
-// recordingBeanEventBody is the shared {"event": ...} body for
-// recording_started and recording_ended, whose payloads carry identical fields.
-type recordingBeanEventBody struct {
-	UniqueKey string `json:"unique_key"`
-	Source    string `json:"source"`
-}
-
-// decodeEventBody unmarshals the {"event": ...} envelope of raw and returns
-// the decoded body; ok is false when the payload does not decode.
-func decodeEventBody[T any](raw *event.RawEvent) (T, bool) {
-	var envelope struct {
-		Event T `json:"event"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		var zero T
-		return zero, false
-	}
-	return envelope.Event, true
-}
-
-// millisToLocalRFC3339 converts a unix-millisecond timestamp string to
-// RFC3339 in the local timezone; empty or non-numeric input yields "".
-func millisToLocalRFC3339(raw string) string {
-	if raw == "" {
-		return ""
-	}
-	millis, err := strconv.ParseInt(raw, 10, 64)
-	if err != nil {
-		return ""
-	}
-	return time.UnixMilli(millis).Local().Format(time.RFC3339)
-}
-
-// unixSecondsToLocalRFC3339 converts a unix-second timestamp string to
-// RFC3339 in the local timezone; empty or non-numeric input yields "".
-func unixSecondsToLocalRFC3339(raw string) string {
-	if raw == "" {
-		return ""
-	}
-	secs, err := strconv.ParseInt(raw, 10, 64)
-	if err != nil {
-		return ""
-	}
-	return time.Unix(secs, 0).Local().Format(time.RFC3339)
-}

events/vc/note_generated.go

@@ -11,7 +11,6 @@ import (
 
 	"github.com/larksuite/cli/errs"
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 	"github.com/larksuite/cli/internal/validate"
 )
 
@@ -43,20 +42,28 @@ type VCNoteGeneratedOutput struct {
 
 func processVCNoteGenerated(ctx context.Context, rt event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
 	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
 		Event struct {
 			NoteID string `json:"note_id"`
 		} `json:"event"`
 	}
 	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
 	out := &VCNoteGeneratedOutput{
-		Type:      raw.EventType,
-		EventID:   raw.EventID,
-		Timestamp: raw.SourceTime,
+		Type:      envelope.Header.EventType,
+		EventID:   envelope.Header.EventID,
+		Timestamp: envelope.Header.CreateTime,
 		NoteID:    envelope.Event.NoteID,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 
 	if rt != nil && out.NoteID != "" {
 		fillVCNoteGeneratedDetails(ctx, rt, out)

events/vc/note_generated_test.go

@@ -10,13 +10,12 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 func TestVCKeys_ProcessedNoteGeneratedRegistered(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, eventTypeNoteGenerated)
+	def, ok := event.Lookup(eventTypeNoteGenerated)
 	if !ok {
 		t.Fatalf("%s should be registered via Keys()", eventTypeNoteGenerated)
 	}
@@ -114,7 +113,7 @@ func TestProcessVCNoteGenerated(t *testing.T) {
 func TestVCNoteGenerated_PreConsumeSubscriptionLifecycle(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, eventTypeNoteGenerated)
+	def, ok := event.Lookup(eventTypeNoteGenerated)
 	if !ok {
 		t.Fatalf("%s should be registered via Keys()", eventTypeNoteGenerated)
 	}
@@ -302,11 +301,11 @@ func TestProcessVCNoteGenerated_MalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processVCNoteGenerated(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
@@ -317,7 +316,6 @@ func runNoteGenerated(t *testing.T, rt event.APIClient, payload string) VCNoteGe
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processVCNoteGenerated(context.Background(), rt, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/vc/participant_meeting_ended.go

@@ -6,9 +6,10 @@ package vc
 import (
 	"context"
 	"encoding/json"
+	"strconv"
+	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCParticipantMeetingEndedOutput is the flattened shape for vc.meeting.participant_meeting_ended_v1.
@@ -24,28 +25,33 @@ type VCParticipantMeetingEndedOutput struct {
 	CalendarEventID string `json:"calendar_event_id,omitempty" desc:"Calendar event ID associated with the meeting"`
 }
 
-type participantMeetingEndedEvent struct {
-	Meeting struct {
-		ID              string `json:"id"`
-		Topic           string `json:"topic"`
-		MeetingNo       string `json:"meeting_no"`
-		StartTime       string `json:"start_time"`
-		EndTime         string `json:"end_time"`
-		CalendarEventID string `json:"calendar_event_id"`
-	} `json:"meeting"`
-}
-
 func processVCParticipantMeetingEnded(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[participantMeetingEndedEvent](raw)
-	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
+		Event struct {
+			Meeting struct {
+				ID              string `json:"id"`
+				Topic           string `json:"topic"`
+				MeetingNo       string `json:"meeting_no"`
+				StartTime       string `json:"start_time"`
+				EndTime         string `json:"end_time"`
+				CalendarEventID string `json:"calendar_event_id"`
+			} `json:"meeting"`
+		} `json:"event"`
+	}
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
-	meeting := body.Meeting
+	meeting := envelope.Event.Meeting
 	out := &VCParticipantMeetingEndedOutput{
-		Type:            raw.EventType,
-		EventID:         raw.EventID,
-		Timestamp:       raw.SourceTime,
+		Type:            envelope.Header.EventType,
+		EventID:         envelope.Header.EventID,
+		Timestamp:       envelope.Header.CreateTime,
 		MeetingID:       meeting.ID,
 		Topic:           meeting.Topic,
 		MeetingNo:       meeting.MeetingNo,
@@ -53,5 +59,19 @@ func processVCParticipantMeetingEnded(_ context.Context, _ event.APIClient, raw
 		EndTime:         unixSecondsToLocalRFC3339(meeting.EndTime),
 		CalendarEventID: meeting.CalendarEventID,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	return json.Marshal(out)
 }
+
+func unixSecondsToLocalRFC3339(raw string) string {
+	if raw == "" {
+		return ""
+	}
+	secs, err := strconv.ParseInt(raw, 10, 64)
+	if err != nil {
+		return ""
+	}
+	return time.Unix(secs, 0).Local().Format(time.RFC3339)
+}

events/vc/participant_meeting_ended_test.go

@@ -6,17 +6,24 @@ package vc
 import (
 	"context"
 	"encoding/json"
+	"os"
 	"testing"
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
+func TestMain(m *testing.M) {
+	for _, k := range Keys() {
+		event.RegisterKey(k)
+	}
+	os.Exit(m.Run())
+}
+
 func TestVCKeys_ProcessedMeetingEndedRegistered(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, eventTypeMeetingEnded)
+	def, ok := event.Lookup(eventTypeMeetingEnded)
 	if !ok {
 		t.Fatalf("%s should be registered via Keys()", eventTypeMeetingEnded)
 	}
@@ -123,18 +130,18 @@ func TestProcessVCParticipantMeetingEnded_MalformedPayload(t *testing.T) {
 		Timestamp: time.Now(),
 	}
 	got, err := processVCParticipantMeetingEnded(context.Background(), nil, raw, nil)
-	if !processing.IsDropMalformed(err) {
-		t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+	if err != nil {
+		t.Fatalf("Process should swallow parse errors, got %v", err)
 	}
-	if got != nil {
-		t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+	if string(got) != "not json" {
+		t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 	}
 }
 
 func TestVCParticipantMeetingEnded_PreConsumeSubscriptionLifecycle(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
-	def, ok := lookupCompiledDef(t, "vc.meeting.participant_meeting_ended_v1")
+	def, ok := event.Lookup("vc.meeting.participant_meeting_ended_v1")
 	if !ok {
 		t.Fatal("vc.meeting.participant_meeting_ended_v1 should be registered via Keys()")
 	}
@@ -184,7 +191,6 @@ func runMeetingEnded(t *testing.T, payload string) VCParticipantMeetingEndedOutp
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := processVCParticipantMeetingEnded(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/vc/participant_meeting_joined.go

@@ -8,7 +8,6 @@ import (
 	"encoding/json"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCParticipantMeetingJoinedOutput is the flattened shape for vc.meeting.participant_meeting_joined_v1.
@@ -23,33 +22,41 @@ type VCParticipantMeetingJoinedOutput struct {
 	CalendarEventID string `json:"calendar_event_id,omitempty" desc:"Calendar event ID associated with the meeting"`
 }
 
-type participantMeetingJoinedEvent struct {
-	Meeting struct {
-		ID              string `json:"id"`
-		Topic           string `json:"topic"`
-		MeetingNo       string `json:"meeting_no"`
-		StartTime       string `json:"start_time"`
-		EndTime         string `json:"end_time"`
-		CalendarEventID string `json:"calendar_event_id"`
-	} `json:"meeting"`
-}
-
 func processVCParticipantMeetingJoined(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[participantMeetingJoinedEvent](raw)
-	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
+		Event struct {
+			Meeting struct {
+				ID              string `json:"id"`
+				Topic           string `json:"topic"`
+				MeetingNo       string `json:"meeting_no"`
+				StartTime       string `json:"start_time"`
+				EndTime         string `json:"end_time"`
+				CalendarEventID string `json:"calendar_event_id"`
+			} `json:"meeting"`
+		} `json:"event"`
+	}
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
-	meeting := body.Meeting
+	meeting := envelope.Event.Meeting
 	out := &VCParticipantMeetingJoinedOutput{
-		Type:            raw.EventType,
-		EventID:         raw.EventID,
-		Timestamp:       raw.SourceTime,
+		Type:            envelope.Header.EventType,
+		EventID:         envelope.Header.EventID,
+		Timestamp:       envelope.Header.CreateTime,
 		MeetingID:       meeting.ID,
 		Topic:           meeting.Topic,
 		MeetingNo:       meeting.MeetingNo,
 		StartTime:       unixSecondsToLocalRFC3339(meeting.StartTime),
 		CalendarEventID: meeting.CalendarEventID,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	return json.Marshal(out)
 }

events/vc/participant_meeting_lifecycle_test.go

@@ -11,7 +11,6 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 func TestVCKeys_ProcessedMeetingLifecycleRegistered(t *testing.T) {
@@ -25,7 +24,7 @@ func TestVCKeys_ProcessedMeetingLifecycleRegistered(t *testing.T) {
 		{eventTypeMeetingJoined, reflect.TypeOf(VCParticipantMeetingJoinedOutput{})},
 	} {
 		t.Run(tc.eventType, func(t *testing.T) {
-			def, ok := lookupCompiledDef(t, tc.eventType)
+			def, ok := event.Lookup(tc.eventType)
 			if !ok {
 				t.Fatalf("%s should be registered via Keys()", tc.eventType)
 			}
@@ -194,11 +193,11 @@ func TestProcessVCParticipantMeetingLifecycle_MalformedPayload(t *testing.T) {
 				Timestamp: time.Now(),
 			}
 			got, err := tc.process(context.Background(), nil, raw, nil)
-			if !processing.IsDropMalformed(err) {
-				t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+			if err != nil {
+				t.Fatalf("Process should swallow parse errors, got %v", err)
 			}
-			if got != nil {
-				t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+			if string(got) != "not json" {
+				t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 			}
 		})
 	}
@@ -209,7 +208,7 @@ func TestVCParticipantMeetingLifecycle_PreConsumeSubscriptionLifecycle(t *testin
 
 	for _, eventType := range []string{eventTypeMeetingStarted, eventTypeMeetingJoined} {
 		t.Run(eventType, func(t *testing.T) {
-			def, ok := lookupCompiledDef(t, eventType)
+			def, ok := event.Lookup(eventType)
 			if !ok {
 				t.Fatalf("%s should be registered via Keys()", eventType)
 			}
@@ -274,7 +273,6 @@ func runMeetingLifecycleRaw(t *testing.T, eventType string, process event.Proces
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := process(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/vc/participant_meeting_started.go

@@ -8,7 +8,6 @@ import (
 	"encoding/json"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCParticipantMeetingStartedOutput is the flattened shape for vc.meeting.participant_meeting_started_v1.
@@ -23,32 +22,40 @@ type VCParticipantMeetingStartedOutput struct {
 	CalendarEventID string `json:"calendar_event_id,omitempty" desc:"Calendar event ID associated with the meeting"`
 }
 
-type participantMeetingStartedEvent struct {
-	Meeting struct {
-		ID              string `json:"id"`
-		Topic           string `json:"topic"`
-		MeetingNo       string `json:"meeting_no"`
-		StartTime       string `json:"start_time"`
-		CalendarEventID string `json:"calendar_event_id"`
-	} `json:"meeting"`
-}
-
 func processVCParticipantMeetingStarted(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[participantMeetingStartedEvent](raw)
-	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+	var envelope struct {
+		Header struct {
+			EventID    string `json:"event_id"`
+			EventType  string `json:"event_type"`
+			CreateTime string `json:"create_time"`
+		} `json:"header"`
+		Event struct {
+			Meeting struct {
+				ID              string `json:"id"`
+				Topic           string `json:"topic"`
+				MeetingNo       string `json:"meeting_no"`
+				StartTime       string `json:"start_time"`
+				CalendarEventID string `json:"calendar_event_id"`
+			} `json:"meeting"`
+		} `json:"event"`
+	}
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return raw.Payload, nil //nolint:nilerr // passthrough on malformed payload so consumers still see the event
 	}
 
-	meeting := body.Meeting
+	meeting := envelope.Event.Meeting
 	out := &VCParticipantMeetingStartedOutput{
-		Type:            raw.EventType,
-		EventID:         raw.EventID,
-		Timestamp:       raw.SourceTime,
+		Type:            envelope.Header.EventType,
+		EventID:         envelope.Header.EventID,
+		Timestamp:       envelope.Header.CreateTime,
 		MeetingID:       meeting.ID,
 		Topic:           meeting.Topic,
 		MeetingNo:       meeting.MeetingNo,
 		StartTime:       unixSecondsToLocalRFC3339(meeting.StartTime),
 		CalendarEventID: meeting.CalendarEventID,
 	}
+	if out.Type == "" {
+		out.Type = raw.EventType
+	}
 	return json.Marshal(out)
 }

events/vc/preconsume.go

@@ -0,0 +1,37 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package vc
+
+import (
+	"context"
+	"time"
+
+	"github.com/larksuite/cli/errs"
+	"github.com/larksuite/cli/internal/event"
+)
+
+const cleanupTimeout = 5 * time.Second
+
+func subscriptionPreConsume(eventType, subscribePath, unsubscribePath string) func(context.Context, event.APIClient, map[string]string) (func() error, error) {
+	return func(ctx context.Context, rt event.APIClient, _ map[string]string) (func() error, error) {
+		if rt == nil {
+			return nil, errs.NewInternalError(errs.SubtypeUnknown,
+				"runtime API client is required for pre-consume subscription")
+		}
+
+		body := map[string]string{"event_type": eventType}
+		if _, err := rt.CallAPI(ctx, "POST", subscribePath, body); err != nil {
+			return nil, err
+		}
+
+		return func() error {
+			cleanupCtx, cancel := context.WithTimeout(context.Background(), cleanupTimeout)
+			defer cancel()
+			if _, err := rt.CallAPI(cleanupCtx, "POST", unsubscribePath, body); err != nil {
+				return err
+			}
+			return nil
+		}, nil
+	}
+}

events/vc/recording_ended.go

@@ -6,9 +6,10 @@ package vc
 import (
 	"context"
 	"encoding/json"
+	"strconv"
+	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCRecordingEndedOutput is the flattened shape for vc.recording.recording_ended_v1.
@@ -20,20 +21,64 @@ type VCRecordingEndedOutput struct {
 	Source    string `json:"source,omitempty"     desc:"Recording source; always recording_bean"`
 }
 
+type recordingEndedEnvelope struct {
+	Header struct {
+		EventID    string `json:"event_id"`
+		EventType  string `json:"event_type"`
+		CreateTime string `json:"create_time"`
+	} `json:"header"`
+	Event recordingEndedEvent `json:"event"`
+}
+
+type recordingEndedEvent struct {
+	UniqueKey string `json:"unique_key"`
+	Source    string `json:"source"`
+}
+
 func processVCRecordingEnded(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[recordingBeanEventBody](raw)
+	envelope, ok := parseRecordingEndedEnvelope(raw)
 	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil
 	}
-	if body.Source != recordingBeanSource {
+	if !isRecordingEndedBeanEvent(envelope) {
 		return nil, nil
 	}
 	out := &VCRecordingEndedOutput{
-		Type:      raw.EventType,
-		EventID:   raw.EventID,
-		EventTime: millisToLocalRFC3339(raw.SourceTime),
-		UniqueKey: body.UniqueKey,
-		Source:    body.Source,
+		Type:      recordingEndedEventType(envelope, raw),
+		EventID:   envelope.Header.EventID,
+		EventTime: recordingEndedEventTime(envelope.Header.CreateTime),
+		UniqueKey: envelope.Event.UniqueKey,
+		Source:    envelope.Event.Source,
 	}
 	return json.Marshal(out)
 }
+
+func parseRecordingEndedEnvelope(raw *event.RawEvent) (*recordingEndedEnvelope, bool) {
+	var envelope recordingEndedEnvelope
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return nil, false
+	}
+	return &envelope, true
+}
+
+func isRecordingEndedBeanEvent(envelope *recordingEndedEnvelope) bool {
+	return envelope != nil && envelope.Event.Source == "recording_bean"
+}
+
+func recordingEndedEventType(envelope *recordingEndedEnvelope, raw *event.RawEvent) string {
+	if envelope != nil && envelope.Header.EventType != "" {
+		return envelope.Header.EventType
+	}
+	return raw.EventType
+}
+
+func recordingEndedEventTime(raw string) string {
+	if raw == "" {
+		return ""
+	}
+	millis, err := strconv.ParseInt(raw, 10, 64)
+	if err != nil {
+		return ""
+	}
+	return time.UnixMilli(millis).Local().Format(time.RFC3339)
+}

events/vc/recording_started.go

@@ -6,9 +6,10 @@ package vc
 import (
 	"context"
 	"encoding/json"
+	"strconv"
+	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCRecordingStartedOutput is the flattened shape for vc.recording.recording_started_v1.
@@ -20,20 +21,64 @@ type VCRecordingStartedOutput struct {
 	Source    string `json:"source,omitempty"     desc:"Recording source; always recording_bean"`
 }
 
+type recordingStartedEnvelope struct {
+	Header struct {
+		EventID    string `json:"event_id"`
+		EventType  string `json:"event_type"`
+		CreateTime string `json:"create_time"`
+	} `json:"header"`
+	Event recordingStartedEvent `json:"event"`
+}
+
+type recordingStartedEvent struct {
+	UniqueKey string `json:"unique_key"`
+	Source    string `json:"source"`
+}
+
 func processVCRecordingStarted(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[recordingBeanEventBody](raw)
+	envelope, ok := parseRecordingStartedEnvelope(raw)
 	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil
 	}
-	if body.Source != recordingBeanSource {
+	if !isRecordingStartedBeanEvent(envelope) {
 		return nil, nil
 	}
 	out := &VCRecordingStartedOutput{
-		Type:      raw.EventType,
-		EventID:   raw.EventID,
-		EventTime: millisToLocalRFC3339(raw.SourceTime),
-		UniqueKey: body.UniqueKey,
-		Source:    body.Source,
+		Type:      recordingStartedEventType(envelope, raw),
+		EventID:   envelope.Header.EventID,
+		EventTime: recordingStartedEventTime(envelope.Header.CreateTime),
+		UniqueKey: envelope.Event.UniqueKey,
+		Source:    envelope.Event.Source,
 	}
 	return json.Marshal(out)
 }
+
+func parseRecordingStartedEnvelope(raw *event.RawEvent) (*recordingStartedEnvelope, bool) {
+	var envelope recordingStartedEnvelope
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return nil, false
+	}
+	return &envelope, true
+}
+
+func isRecordingStartedBeanEvent(envelope *recordingStartedEnvelope) bool {
+	return envelope != nil && envelope.Event.Source == "recording_bean"
+}
+
+func recordingStartedEventType(envelope *recordingStartedEnvelope, raw *event.RawEvent) string {
+	if envelope != nil && envelope.Header.EventType != "" {
+		return envelope.Header.EventType
+	}
+	return raw.EventType
+}
+
+func recordingStartedEventTime(raw string) string {
+	if raw == "" {
+		return ""
+	}
+	millis, err := strconv.ParseInt(raw, 10, 64)
+	if err != nil {
+		return ""
+	}
+	return time.UnixMilli(millis).Local().Format(time.RFC3339)
+}

events/vc/recording_test.go

@@ -12,7 +12,6 @@ import (
 	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 func TestVCKeys_RecordingEventsRegistered(t *testing.T) {
@@ -26,7 +25,7 @@ func TestVCKeys_RecordingEventsRegistered(t *testing.T) {
 		{eventTypeRecordingEnded},
 	} {
 		t.Run(tc.eventType, func(t *testing.T) {
-			def, ok := lookupCompiledDef(t, tc.eventType)
+			def, ok := event.Lookup(tc.eventType)
 			if !ok {
 				t.Fatalf("%s should be registered via Keys()", tc.eventType)
 			}
@@ -352,7 +351,7 @@ func TestProcessVCRecording_NonRecordingBeanFiltered(t *testing.T) {
 	}
 }
 
-func TestProcessVCRecording_MalformedPayloadDrop(t *testing.T) {
+func TestProcessVCRecording_MalformedPayloadPassthrough(t *testing.T) {
 	t.Setenv("LARKSUITE_CLI_CONFIG_DIR", t.TempDir())
 
 	for _, tc := range []struct {
@@ -371,11 +370,11 @@ func TestProcessVCRecording_MalformedPayloadDrop(t *testing.T) {
 				Timestamp: time.Now(),
 			}
 			got, err := tc.process(context.Background(), nil, raw, nil)
-			if !processing.IsDropMalformed(err) {
-				t.Fatalf("malformed payload must be dropped with a malformed marker, got err=%v", err)
+			if err != nil {
+				t.Fatalf("Process should swallow parse errors, got %v", err)
 			}
-			if got != nil {
-				t.Errorf("malformed payload must be dropped without output, got %q", string(got))
+			if string(got) != "not json" {
+				t.Errorf("malformed fallback output = %q, want original bytes", string(got))
 			}
 		})
 	}
@@ -392,7 +391,7 @@ func TestVCRecording_PreConsumeSubscriptionLifecycle(t *testing.T) {
 		{eventTypeRecordingEnded},
 	} {
 		t.Run(tc.eventType, func(t *testing.T) {
-			def, ok := lookupCompiledDef(t, tc.eventType)
+			def, ok := event.Lookup(tc.eventType)
 			if !ok {
 				t.Fatalf("%s should be registered via Keys()", tc.eventType)
 			}
@@ -457,7 +456,6 @@ func runRecordingProcessRaw(t *testing.T, eventType string, process event.Proces
 		Payload:   json.RawMessage(payload),
 		Timestamp: time.Now(),
 	}
-	fillCanonicalFromHeader(t, raw)
 	got, err := process(context.Background(), nil, raw, nil)
 	if err != nil {
 		t.Fatalf("Process error: %v", err)

events/vc/recording_transcript_generated.go

@@ -6,9 +6,10 @@ package vc
 import (
 	"context"
 	"encoding/json"
+	"strconv"
+	"time"
 
 	"github.com/larksuite/cli/internal/event"
-	"github.com/larksuite/cli/internal/event/processing"
 )
 
 // VCRecordingTranscriptItemOutput is one flattened transcript item for recording events.
@@ -30,6 +31,15 @@ type VCRecordingTranscriptGeneratedOutput struct {
 	TranscriptItems []VCRecordingTranscriptItemOutput `json:"transcript_items,omitempty" desc:"Generated transcript items"`
 }
 
+type recordingTranscriptGeneratedEnvelope struct {
+	Header struct {
+		EventID    string `json:"event_id"`
+		EventType  string `json:"event_type"`
+		CreateTime string `json:"create_time"`
+	} `json:"header"`
+	Event recordingTranscriptGeneratedEvent `json:"event"`
+}
+
 type recordingTranscriptGeneratedEvent struct {
 	UniqueKey       string                               `json:"unique_key"`
 	Source          string                               `json:"source"`
@@ -51,24 +61,58 @@ type recordingTranscriptGeneratedSpeakerIn struct {
 type recordingTranscriptGeneratedString string
 
 func processVCRecordingTranscriptGenerated(_ context.Context, _ event.APIClient, raw *event.RawEvent, _ map[string]string) (json.RawMessage, error) {
-	body, ok := decodeEventBody[recordingTranscriptGeneratedEvent](raw)
+	envelope, ok := parseRecordingTranscriptGeneratedEnvelope(raw)
 	if !ok {
-		return nil, processing.DropMalformed(raw.EventType)
+		return raw.Payload, nil
 	}
-	if body.Source != recordingBeanSource {
+	if !isRecordingTranscriptGeneratedBeanEvent(envelope) {
 		return nil, nil
 	}
 	out := &VCRecordingTranscriptGeneratedOutput{
-		Type:            raw.EventType,
-		EventID:         raw.EventID,
-		EventTime:       millisToLocalRFC3339(raw.SourceTime),
-		UniqueKey:       body.UniqueKey,
-		Source:          body.Source,
-		TranscriptItems: recordingTranscriptItems(body.TranscriptItems),
+		Type:            recordingTranscriptGeneratedEventType(envelope, raw),
+		EventID:         envelope.Header.EventID,
+		EventTime:       recordingTranscriptGeneratedEventTime(envelope.Header.CreateTime),
+		UniqueKey:       envelope.Event.UniqueKey,
+		Source:          envelope.Event.Source,
+		TranscriptItems: recordingTranscriptItems(envelope.Event.TranscriptItems),
 	}
 	return json.Marshal(out)
 }
 
+func parseRecordingTranscriptGeneratedEnvelope(raw *event.RawEvent) (*recordingTranscriptGeneratedEnvelope, bool) {
+	var envelope recordingTranscriptGeneratedEnvelope
+	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
+		return nil, false
+	}
+	return &envelope, true
+}
+
+func isRecordingTranscriptGeneratedBeanEvent(envelope *recordingTranscriptGeneratedEnvelope) bool {
+	return envelope != nil && envelope.Event.Source == "recording_bean"
+}
+
+func recordingTranscriptGeneratedEventType(envelope *recordingTranscriptGeneratedEnvelope, raw *event.RawEvent) string {
+	if envelope != nil && envelope.Header.EventType != "" {
+		return envelope.Header.EventType
+	}
+	return raw.EventType
+}
+
+func recordingTranscriptGeneratedEventTime(raw string) string {
+	return recordingTranscriptGeneratedMillisToLocalRFC3339(raw)
+}
+
+func recordingTranscriptGeneratedMillisToLocalRFC3339(raw string) string {
+	if raw == "" {
+		return ""
+	}
+	millis, err := strconv.ParseInt(raw, 10, 64)
+	if err != nil {
+		return ""
+	}
+	return time.UnixMilli(millis).Local().Format(time.RFC3339)
+}
+
 func recordingTranscriptItems(items []recordingTranscriptGeneratedItemIn) []VCRecordingTranscriptItemOutput {
 	if len(items) == 0 {
 		return nil
@@ -84,8 +128,8 @@ func recordingTranscriptItem(item recordingTranscriptGeneratedItemIn) VCRecordin
 	return VCRecordingTranscriptItemOutput{
 		SpeakerName: recordingSpeakerName(item.Speaker),
 		Text:        item.Text,
-		StartTime:   millisToLocalRFC3339(item.StartTimeMs.String()),
-		EndTime:     millisToLocalRFC3339(item.EndTimeMs.String()),
+		StartTime:   recordingTranscriptGeneratedMillisToLocalRFC3339(item.StartTimeMs.String()),
+		EndTime:     recordingTranscriptGeneratedMillisToLocalRFC3339(item.EndTimeMs.String()),
 		SentenceID:  item.SentenceID,
 	}
 }

events/vc/register.go

@@ -7,7 +7,6 @@ package vc
 import (
 	"reflect"
 
-	"github.com/larksuite/cli/events/internal/subscribeprep"
 	"github.com/larksuite/cli/internal/event"
 )
 
@@ -42,7 +41,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCParticipantMeetingStartedOutput{})},
 			},
 			Process:    processVCParticipantMeetingStarted,
-			PreConsume: subscribeprep.Hook(eventTypeMeetingStarted, pathMeetingSubscribe, pathMeetingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeMeetingStarted, pathMeetingSubscribe, pathMeetingUnsubscribe),
 			Scopes:     []string{"vc:meeting.meetingevent:read"},
 			AuthTypes: []string{
 				"user",
@@ -58,7 +57,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCParticipantMeetingJoinedOutput{})},
 			},
 			Process:    processVCParticipantMeetingJoined,
-			PreConsume: subscribeprep.Hook(eventTypeMeetingJoined, pathMeetingSubscribe, pathMeetingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeMeetingJoined, pathMeetingSubscribe, pathMeetingUnsubscribe),
 			Scopes:     []string{"vc:meeting.meetingevent:read"},
 			AuthTypes: []string{
 				"user",
@@ -74,7 +73,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCParticipantMeetingEndedOutput{})},
 			},
 			Process:    processVCParticipantMeetingEnded,
-			PreConsume: subscribeprep.Hook(eventTypeMeetingEnded, pathMeetingSubscribe, pathMeetingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeMeetingEnded, pathMeetingSubscribe, pathMeetingUnsubscribe),
 			Scopes:     []string{"vc:meeting.meetingevent:read"},
 			AuthTypes: []string{
 				"user",
@@ -90,7 +89,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCNoteGeneratedOutput{})},
 			},
 			Process:    processVCNoteGenerated,
-			PreConsume: subscribeprep.Hook(eventTypeNoteGenerated, pathNoteSubscribe, pathNoteUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeNoteGenerated, pathNoteSubscribe, pathNoteUnsubscribe),
 			Scopes:     []string{"vc:note:read"},
 			AuthTypes: []string{
 				"user",
@@ -106,7 +105,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCRecordingStartedOutput{})},
 			},
 			Process:    processVCRecordingStarted,
-			PreConsume: subscribeprep.Hook(eventTypeRecordingStarted, pathRecordingSubscribe, pathRecordingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeRecordingStarted, pathRecordingSubscribe, pathRecordingUnsubscribe),
 			Scopes:     []string{"vc:recording:read"},
 			AuthTypes: []string{
 				"user",
@@ -122,7 +121,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCRecordingTranscriptGeneratedOutput{})},
 			},
 			Process:    processVCRecordingTranscriptGenerated,
-			PreConsume: subscribeprep.Hook(eventTypeRecordingTranscriptGenerated, pathRecordingSubscribe, pathRecordingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeRecordingTranscriptGenerated, pathRecordingSubscribe, pathRecordingUnsubscribe),
 			Scopes:     []string{"vc:recording:read"},
 			AuthTypes: []string{
 				"user",
@@ -138,7 +137,7 @@ func Keys() []event.KeyDefinition {
 				Custom: &event.SchemaSpec{Type: reflect.TypeOf(VCRecordingEndedOutput{})},
 			},
 			Process:    processVCRecordingEnded,
-			PreConsume: subscribeprep.Hook(eventTypeRecordingEnded, pathRecordingSubscribe, pathRecordingUnsubscribe),
+			PreConsume: subscriptionPreConsume(eventTypeRecordingEnded, pathRecordingSubscribe, pathRecordingUnsubscribe),
 			Scopes:     []string{"vc:recording:read"},
 			AuthTypes: []string{
 				"user",

events/vc/test_helpers_test.go

@@ -8,34 +8,8 @@ import (
 	"encoding/json"
 	"reflect"
 	"testing"
-
-	"github.com/larksuite/cli/internal/event"
 )
 
-// fillCanonicalFromHeader copies the payload envelope header metadata onto
-// the RawEvent canonical fields. Process handlers read event_id and
-// create_time from the RawEvent, which the consume pipeline fills from the
-// envelope header before dispatch; tests that hand-build a RawEvent must
-// mirror that so both views agree.
-func fillCanonicalFromHeader(t *testing.T, raw *event.RawEvent) {
-	t.Helper()
-	var envelope struct {
-		Header struct {
-			EventID    string `json:"event_id"`
-			EventType  string `json:"event_type"`
-			CreateTime string `json:"create_time"`
-		} `json:"header"`
-	}
-	if err := json.Unmarshal(raw.Payload, &envelope); err != nil {
-		t.Fatalf("parse envelope header: %v", err)
-	}
-	raw.EventID = envelope.Header.EventID
-	if envelope.Header.EventType != "" {
-		raw.EventType = envelope.Header.EventType
-	}
-	raw.SourceTime = envelope.Header.CreateTime
-}
-
 type stubAPIClient struct {
 	callFn func(ctx context.Context, method, path string, body any) (json.RawMessage, error)
 }

events/whiteboard/preconsume.go

@@ -6,13 +6,17 @@ package whiteboard
 import (
 	"context"
 	"fmt"
+	"time"
 
 	"github.com/larksuite/cli/errs"
-	"github.com/larksuite/cli/events/internal/subscribeprep"
 	"github.com/larksuite/cli/internal/event"
 	"github.com/larksuite/cli/internal/validate"
 )
 
+// cleanupTimeout bounds how long the unsubscribe call has to finish during
+// PreConsume cleanup so a stuck OAPI cannot block process shutdown.
+const cleanupTimeout = 5 * time.Second
+
 // whiteboardSubscriptionPreConsume calls the whiteboard event subscribe OAPI
 // and returns a cleanup that invokes the matching unsubscribe.
 //
@@ -35,6 +39,18 @@ func whiteboardSubscriptionPreConsume(eventType string) func(context.Context, ev
 		subscribePath := fmt.Sprintf("/open-apis/board/v1/whiteboards/%s/subscribe", encoded)
 		unsubscribePath := fmt.Sprintf("/open-apis/board/v1/whiteboards/%s/unsubscribe", encoded)
 
-		return subscribeprep.SubscribeWithCleanup(ctx, rt, eventType, subscribePath, unsubscribePath)
+		body := map[string]string{"event_type": eventType}
+		if _, err := rt.CallAPI(ctx, "POST", subscribePath, body); err != nil {
+			return nil, err
+		}
+
+		return func() error {
+			cleanupCtx, cancel := context.WithTimeout(context.Background(), cleanupTimeout)
+			defer cancel()
+			if _, err := rt.CallAPI(cleanupCtx, "POST", unsubscribePath, body); err != nil {
+				return err
+			}
+			return nil
+		}, nil
 	}
 }

events/whiteboard/register.go

@@ -24,15 +24,10 @@ func Keys() []event.KeyDefinition {
 			EventType:   eventTypeWhiteboardUpdated,
 			Params: []event.ParamDef{
 				{
-					Name:     "whiteboard_id",
-					Type:     event.ParamString,
-					Required: true,
-					// The server-side subscription is keyed per whiteboard, so
-					// the id must be part of the consumer's subscription
-					// identity: consumers of different whiteboards get their
-					// own setup/cleanup lifecycle instead of sharing one.
-					SubscriptionKey: true,
-					Description:     "Whiteboard id to subscribe; subscription is per-whiteboard.",
+					Name:        "whiteboard_id",
+					Type:        event.ParamString,
+					Required:    true,
+					Description: "Whiteboard id to subscribe; subscription is per-whiteboard.",
 				},
 			},
 			Schema: event.SchemaDef{

events/whiteboard/subscription_scope_test.go

@@ -1,36 +0,0 @@
-// Copyright (c) 2026 Lark Technologies Pte. Ltd.
-// SPDX-License-Identifier: MIT
-
-package whiteboard
-
-import (
-	"testing"
-
-	event "github.com/larksuite/cli/internal/event"
-)
-
-// The whiteboard subscription is registered per whiteboard on the server, so
-// the whiteboard id must take part in the consumer's subscription identity.
-// Without it, two consumers of different whiteboards share one scope: the
-// second consumer's setup never runs (its whiteboard is never subscribed) and
-// whichever exits last unsubscribes the other one's still-active board.
-func TestWhiteboardID_IsPartOfSubscriptionIdentity(t *testing.T) {
-	defs := Keys()
-	if len(defs) != 1 {
-		t.Fatalf("expected exactly one whiteboard key, got %d", len(defs))
-	}
-	def := defs[0]
-
-	var found *event.ParamDef
-	for i := range def.Params {
-		if def.Params[i].Name == "whiteboard_id" {
-			found = &def.Params[i]
-		}
-	}
-	if found == nil {
-		t.Fatal("whiteboard_id param is missing")
-	}
-	if !found.SubscriptionKey {
-		t.Error("whiteboard_id must be a subscription key: the server-side subscription is per-whiteboard")
-	}
-}

extension/transport/sidecar/interceptor_test.go

@@ -12,9 +12,18 @@ import (
 	"net/http"
 	"testing"
 
+	exttransport "github.com/larksuite/cli/extension/transport"
+	"github.com/larksuite/cli/internal/envvars"
+	internaltransport "github.com/larksuite/cli/internal/transport"
 	"github.com/larksuite/cli/sidecar"
 )
 
+type roundTripFunc func(*http.Request) (*http.Response, error)
+
+func (f roundTripFunc) RoundTrip(req *http.Request) (*http.Response, error) {
+	return f(req)
+}
+
 // failingBody is a ReadCloser that errors on Read and tracks Close calls.
 type failingBody struct {
 	err      error
@@ -263,3 +272,55 @@ func TestInterceptor_EmptyBody(t *testing.T) {
 		t.Errorf("body SHA256 = %q, want empty-string SHA256 %q", sha, expectedEmpty)
 	}
 }
+
+func TestLegacySidecarProviderStillHandlesForcedExternalRequests(t *testing.T) {
+	t.Setenv(envvars.CliAuthProxy, "http://127.0.0.1:16384")
+	t.Setenv(envvars.CliProxyKey, "test-key")
+	previousProvider := exttransport.GetProvider()
+	exttransport.Register(&Provider{})
+	t.Cleanup(func() { exttransport.Register(previousProvider) })
+
+	seen := make(chan *http.Request, 2)
+	base := roundTripFunc(func(req *http.Request) (*http.Response, error) {
+		seen <- req.Clone(req.Context())
+		return &http.Response{StatusCode: http.StatusNoContent, Body: http.NoBody, Request: req}, nil
+	})
+	client := internaltransport.ClientForRequestClass(
+		&http.Client{Transport: internaltransport.NewHTTPPolicyRouter(base, base)},
+		exttransport.RequestClassExternal,
+	)
+
+	withSentinel, err := http.NewRequest(http.MethodGet, "https://external.example/protected", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	withSentinel.Header.Set("Authorization", "Bearer "+sidecar.SentinelUAT)
+	resp, err := client.Do(withSentinel)
+	if err != nil {
+		t.Fatal(err)
+	}
+	resp.Body.Close()
+
+	withoutSentinel, err := http.NewRequest(http.MethodGet, "https://external.example/public", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	resp, err = client.Do(withoutSentinel)
+	if err != nil {
+		t.Fatal(err)
+	}
+	resp.Body.Close()
+
+	proxied := <-seen
+	if proxied.URL.Scheme != "http" || proxied.URL.Host != "127.0.0.1:16384" {
+		t.Fatalf("sentinel request URL = %s, want sidecar route", proxied.URL)
+	}
+	if got := proxied.Header.Get(sidecar.HeaderProxyTarget); got != "https://external.example" {
+		t.Fatalf("sentinel request proxy target = %q", got)
+	}
+
+	passthrough := <-seen
+	if got := passthrough.URL.String(); got != "https://external.example/public" {
+		t.Fatalf("non-sentinel request URL = %q, want unchanged", got)
+	}
+}

extension/transport/types.go

@@ -15,6 +15,27 @@ type Provider interface {
 	ResolveInterceptor(ctx context.Context) Interceptor
 }
 
+// RequestClass describes the trust boundary of an outbound HTTP request.
+// Platform requests target endpoints owned by the CLI's endpoint resolver;
+// external requests target user-provided, pre-signed, CDN, registry, or other
+// non-platform URLs. Redirect targets are classified again from each hop's
+// logical URL; rewriting a host in an interceptor does not add that host to
+// the platform endpoint catalog.
+type RequestClass string
+
+const (
+	RequestClassPlatform RequestClass = "platform"
+	RequestClassExternal RequestClass = "external"
+)
+
+// ScopedProvider optionally limits a Provider to selected request classes.
+// Providers that do not implement this interface retain the original
+// behavior and apply to every request class.
+type ScopedProvider interface {
+	Provider
+	SupportsRequestClass(RequestClass) bool
+}
+
 // Interceptor defines network-layer customization via a pre/post hook pair.
 // The built-in transport chain always executes between PreRoundTrip and the
 // returned post function, and cannot be skipped or overridden by the extension.

internal/auth/transport.go

@@ -17,6 +17,8 @@ import (
 	"github.com/larksuite/cli/internal/transport"
 )
 
+var _ transport.RoundTripperDecorator = (*SecurityPolicyTransport)(nil)
+
 // SecurityPolicyTransport is an http.RoundTripper that intercepts all responses
 // and checks for security policy errors.
 type SecurityPolicyTransport struct {
@@ -31,6 +33,16 @@ func (t *SecurityPolicyTransport) base() http.RoundTripper {
 	return transport.Fallback()
 }
 
+func (t *SecurityPolicyTransport) BaseRoundTripper() http.RoundTripper {
+	return t.base()
+}
+
+func (t *SecurityPolicyTransport) WithBaseRoundTripper(base http.RoundTripper) http.RoundTripper {
+	cloned := *t
+	cloned.Base = base
+	return &cloned
+}
+
 // RoundTrip implements http.RoundTripper.
 func (t *SecurityPolicyTransport) RoundTrip(req *http.Request) (*http.Response, error) {
 	resp, err := t.base().RoundTrip(req)

internal/client/client.go

@@ -212,6 +212,9 @@ func (c *APIClient) DoStream(ctx context.Context, req *larkcore.ApiReq, as core.
 	resp, err := httpClient.Do(httpReq)
 	if err != nil {
 		cancel()
+		if _, ok := errs.ProblemOf(err); ok {
+			return nil, err
+		}
 		return nil, errs.NewNetworkError(classifyNetworkSubtype(err), "stream request failed: %s", err).WithCause(err)
 	}
 	resp.Body = &cancelOnCloseBody{ReadCloser: resp.Body, cancel: cancel}

internal/client/client_test.go

@@ -518,6 +518,29 @@ func TestDoStream_TransportFailureSplitsSubtype(t *testing.T) {
 	}
 }
 
+func TestDoStream_PreservesTypedTransportError(t *testing.T) {
+	policyErr := errs.NewSecurityPolicyError(errs.SubtypeAccessDenied, "blocked redirect")
+	ac := &APIClient{
+		HTTP: &http.Client{Transport: roundTripFunc(func(*http.Request) (*http.Response, error) {
+			return nil, policyErr
+		})},
+		Credential: credential.NewCredentialProvider(nil, nil, &staticTokenResolver{}, nil),
+		Config:     &core.CliConfig{AppID: "test-app", AppSecret: "test-secret", Brand: core.BrandFeishu},
+	}
+
+	_, err := ac.DoStream(context.Background(), &larkcore.ApiReq{
+		HttpMethod: http.MethodGet,
+		ApiPath:    "/open-apis/drive/v1/files/file_token/download",
+	}, core.AsBot)
+	problem, ok := errs.ProblemOf(err)
+	if !ok || problem.Category != errs.CategoryPolicy || problem.Subtype != errs.SubtypeAccessDenied {
+		t.Fatalf("DoStream() problem = %#v, %v; want policy/access_denied", problem, ok)
+	}
+	if !errors.Is(err, policyErr) {
+		t.Fatal("DoStream() did not preserve the typed transport error")
+	}
+}
+
 // failingTokenResolver always returns TokenUnavailableError, exercising the
 // auth/credential failure path through resolveAccessToken.
 type failingTokenResolver struct{}

internal/cmdutil/factory.go

@@ -16,10 +16,12 @@ import (
 	"github.com/larksuite/cli/errs"
 	extcred "github.com/larksuite/cli/extension/credential"
 	"github.com/larksuite/cli/extension/fileio"
+	exttransport "github.com/larksuite/cli/extension/transport"
 	"github.com/larksuite/cli/internal/client"
 	"github.com/larksuite/cli/internal/core"
 	"github.com/larksuite/cli/internal/credential"
 	"github.com/larksuite/cli/internal/keychain"
+	"github.com/larksuite/cli/internal/transport"
 )
 
 // Factory holds shared dependencies injected into every command.
@@ -31,7 +33,7 @@ type InvocationContext struct {
 
 type Factory struct {
 	Config     func() (*core.CliConfig, error) // lazily loads app config from Credential
-	HttpClient func() (*http.Client, error)    // HTTP client for non-Lark API calls (with retry and security headers)
+	HttpClient func() (*http.Client, error)    // policy-routed HTTP client for direct requests
 	LarkClient func() (*lark.Client, error)    // Lark SDK client for all Open API calls
 	IOStreams  *IOStreams                      // stdin/stdout/stderr streams
 
@@ -48,6 +50,18 @@ type Factory struct {
 	SkillContent fs.FS // embedded skill tree (rooted at the skill list); nil when the build embeds no skills
 }
 
+// ExternalHTTPClient returns a clone of the existing Factory client whose
+// requests are explicitly classified as external. The underlying client,
+// redirect policy, timeout, proxy configuration, and legacy transport provider
+// behavior are preserved.
+func (f *Factory) ExternalHTTPClient() (*http.Client, error) {
+	client, err := f.HttpClient()
+	if err != nil {
+		return nil, err
+	}
+	return transport.ClientForRequestClass(client, exttransport.RequestClassExternal), nil
+}
+
 // ResolveFileIO resolves a FileIO instance using the current execution context.
 // The provider controls whether the returned instance is fresh or cached.
 func (f *Factory) ResolveFileIO(ctx context.Context) fileio.FileIO {

internal/cmdutil/factory_default.go

@@ -5,16 +5,18 @@ package cmdutil
 
 import (
 	"context"
-	"fmt"
 	"io"
 	"net/http"
+	"net/url"
 	"os"
+	"strings"
 	"sync"
 	"time"
 
 	lark "github.com/larksuite/oapi-sdk-go/v3"
 	larkcore "github.com/larksuite/oapi-sdk-go/v3/core"
 
+	"github.com/larksuite/cli/errs"
 	extcred "github.com/larksuite/cli/extension/credential"
 	"github.com/larksuite/cli/extension/fileio"
 	"github.com/larksuite/cli/internal/auth"
@@ -48,6 +50,19 @@ func NewDefault(streams *IOStreams, inv InvocationContext) *Factory {
 	// workspace-scoped. Default is WorkspaceLocal — existing behavior unchanged.
 	ws := core.DetectWorkspaceFromEnv(os.Getenv)
 	core.SetCurrentWorkspace(ws)
+	workspaceConfig := core.NewConfigSnapshot()
+	bootstrapHostSignalSource := sync.OnceValue(func() riskcontrol.Source {
+		return resolveSDKHostSignalSource(workspaceConfig)
+	})
+	// Install after workspace selection so the dependency bootstrap bridge uses
+	// the correct shared proxy configuration. NewDefault is also used by cmd.Build
+	// consumers, so this keeps their request routing identical to cmd.Execute.
+	transport.InstallSDKTransportBridge(func(base http.RoundTripper) http.RoundTripper {
+		return buildSDKPlatformTransportWithBase(
+			base,
+			bootstrapHostSignalSource(),
+		)
+	})
 
 	// Inject workspace-aware dir into keychain's log system.
 	// This breaks the core↔keychain import cycle by using a function variable.
@@ -55,7 +70,6 @@ func NewDefault(streams *IOStreams, inv InvocationContext) *Factory {
 
 	// Phase 0: FileIO provider (no dependency)
 	f.FileIOProvider = fileio.GetProvider()
-	workspaceConfig := core.NewConfigSnapshot()
 
 	// Phase 1: HttpClient (no credential dependency)
 	f.HttpClient = cachedHttpClientFunc(f, workspaceConfig)
@@ -87,15 +101,45 @@ func NewDefault(streams *IOStreams, inv InvocationContext) *Factory {
 	return f
 }
 
-// safeRedirectPolicy prevents credential headers from being forwarded
-// when a response redirects to a different host (e.g. Lark API 302 → CDN).
-// Strips Authorization, X-Lark-MCP-UAT, and X-Lark-MCP-TAT on cross-host
-// redirects; other headers like X-Cli-* pass through.
+// safeRedirectPolicy permits cross-origin redirects only for bodyless GET and
+// HEAD requests. This allows API download redirects while preventing OAuth or
+// other credential-bearing request bodies from being replayed to another
+// origin. HTTPS requests can never be downgraded to HTTP.
 func safeRedirectPolicy(req *http.Request, via []*http.Request) error {
 	if len(via) >= 10 {
-		return fmt.Errorf("too many redirects")
+		return errs.NewNetworkError(errs.SubtypeNetworkTransport, "too many redirects")
 	}
-	if len(via) > 0 && req.URL.Host != via[0].URL.Host {
+	if len(via) == 0 {
+		return nil
+	}
+	original := via[0]
+	previous := via[len(via)-1]
+	if previous.URL != nil && req.URL != nil && strings.EqualFold(previous.URL.Scheme, "https") && !strings.EqualFold(req.URL.Scheme, "https") {
+		return errs.NewSecurityPolicyError(
+			errs.SubtypeAccessDenied,
+			"redirect from HTTPS to %s is not allowed",
+			req.URL.Scheme,
+		)
+	}
+	if !sameRedirectOrigin(previous.URL, req.URL) {
+		if req.Method != http.MethodGet && req.Method != http.MethodHead {
+			return errs.NewSecurityPolicyError(
+				errs.SubtypeAccessDenied,
+				"cross-origin redirect for HTTP method %s is not allowed",
+				req.Method,
+			)
+		}
+		if req.Body != nil || req.GetBody != nil {
+			return errs.NewSecurityPolicyError(
+				errs.SubtypeAccessDenied,
+				"cross-origin redirect with a request body is not allowed",
+			)
+		}
+	}
+	// net/http copies initial headers onto every redirect request. Continue
+	// stripping credentials for every hop outside the initial origin, even when
+	// two consecutive redirect targets share an origin.
+	if !sameRedirectOrigin(original.URL, req.URL) {
 		req.Header.Del("Authorization")
 		req.Header.Del("X-Lark-MCP-UAT")
 		req.Header.Del("X-Lark-MCP-TAT")
@@ -103,6 +147,29 @@ func safeRedirectPolicy(req *http.Request, via []*http.Request) error {
 	return nil
 }
 
+func sameRedirectOrigin(left, right *url.URL) bool {
+	if left == nil || right == nil {
+		return false
+	}
+	return strings.EqualFold(left.Scheme, right.Scheme) &&
+		strings.EqualFold(left.Hostname(), right.Hostname()) &&
+		effectivePort(left) == effectivePort(right)
+}
+
+func effectivePort(candidate *url.URL) string {
+	if port := candidate.Port(); port != "" {
+		return port
+	}
+	switch strings.ToLower(candidate.Scheme) {
+	case "http":
+		return "80"
+	case "https":
+		return "443"
+	default:
+		return ""
+	}
+}
+
 // warnIfProxied is a test seam for the proxy-warning gate. Production wires it
 // to transport.WarnIfProxied; tests swap in a spy to count invocations. It is
 // needed because the real function is guarded by an internal sync.Once, so
@@ -118,15 +185,12 @@ func cachedHttpClientFunc(f *Factory, workspaceConfig workspaceConfigSource) fun
 		}
 
 		hostSignalSource := resolveSDKHostSignalSource(workspaceConfig)
-
-		var rt http.RoundTripper = transport.Shared()
-		rt = riskcontrol.NewTransport(rt, hostSignalSource)
-		rt = &RetryTransport{Base: rt}
-		rt = &SecurityHeaderTransport{Base: rt}
-		rt = &auth.SecurityPolicyTransport{Base: rt} // Add our global response interceptor
-		rt = wrapWithExtension(rt)
+		shared := transport.Shared()
+		outbound := riskcontrol.NewTransport(shared, hostSignalSource)
+		platform := buildDirectHTTPTransport(outbound, true)
+		external := buildDirectHTTPTransport(outbound, false)
 		client := &http.Client{
-			Transport:     rt,
+			Transport:     transport.NewHTTPPolicyRouter(platform, external),
 			Timeout:       30 * time.Second,
 			CheckRedirect: safeRedirectPolicy,
 		}
@@ -134,6 +198,15 @@ func cachedHttpClientFunc(f *Factory, workspaceConfig workspaceConfigSource) fun
 	})
 }
 
+func buildDirectHTTPTransport(base http.RoundTripper, platform bool) http.RoundTripper {
+	var builtIn http.RoundTripper = &RetryTransport{Base: base}
+	builtIn = &SecurityHeaderTransport{Base: builtIn}
+	if platform {
+		builtIn = &auth.SecurityPolicyTransport{Base: builtIn}
+	}
+	return builtIn
+}
+
 func cachedLarkClientFunc(f *Factory, workspaceConfig workspaceConfigSource) func() (*lark.Client, error) {
 	return sync.OnceValues(func() (*lark.Client, error) {
 		acct, err := f.Credential.ResolveAccount(context.Background())
@@ -149,14 +222,8 @@ func cachedLarkClientFunc(f *Factory, workspaceConfig workspaceConfigSource) fun
 			warnIfProxied(f.IOStreams.ErrOut)
 		}
 		hostSignalSource := resolveSDKHostSignalSource(workspaceConfig)
-		var sdkBase http.RoundTripper = transport.Shared()
-		// The innermost SDK boundary always strips reserved host-signal headers;
-		// a nil source makes it strip-only when workspace policy disables signal
-		// collection.
-		sdkBase = riskcontrol.NewTransport(sdkBase, hostSignalSource)
-		sdkTransport := wrapSDKTransport(sdkBase)
 		opts = append(opts, lark.WithHttpClient(&http.Client{
-			Transport:     sdkTransport,
+			Transport:     buildSDKTransport(hostSignalSource),
 			CheckRedirect: safeRedirectPolicy,
 		}))
 		ep := core.ResolveEndpoints(acct.Brand)
@@ -165,12 +232,41 @@ func cachedLarkClientFunc(f *Factory, workspaceConfig workspaceConfigSource) fun
 	})
 }
 
-func wrapSDKTransport(next http.RoundTripper) http.RoundTripper {
-	var sdkTransport http.RoundTripper = &RetryTransport{Base: next}
-	sdkTransport = &UserAgentTransport{Base: sdkTransport}
-	sdkTransport = &BuildHeaderTransport{Base: sdkTransport}
-	sdkTransport = &auth.SecurityPolicyTransport{Base: sdkTransport}
-	return wrapWithExtension(sdkTransport)
+func buildSDKTransport(hostSignalSource riskcontrol.Source) http.RoundTripper {
+	return buildSDKTransportWithBase(transport.Shared(), hostSignalSource)
+}
+
+func buildSDKPlatformTransportWithBase(
+	base http.RoundTripper,
+	hostSignalSource riskcontrol.Source,
+) http.RoundTripper {
+	outbound := riskcontrol.NewTransport(base, hostSignalSource)
+	return buildSDKHTTPTransport(outbound, true)
+}
+
+func buildSDKTransportWithBase(
+	base http.RoundTripper,
+	hostSignalSource riskcontrol.Source,
+) http.RoundTripper {
+	// Risk control is the innermost trusted boundary for both request classes.
+	// It therefore observes the final URL and strips extension-supplied reserved
+	// headers immediately before the network transport.
+	outbound := riskcontrol.NewTransport(base, hostSignalSource)
+	return transport.NewHTTPPolicyRouter(
+		buildSDKHTTPTransport(outbound, true),
+		buildSDKHTTPTransport(outbound, false),
+	)
+}
+
+func buildSDKHTTPTransport(base http.RoundTripper, platform bool) http.RoundTripper {
+	var builtIn http.RoundTripper = &RetryTransport{Base: base}
+	builtIn = &UserAgentTransport{Base: builtIn}
+	builtIn = &BuildHeaderTransport{Base: builtIn}
+	builtIn = &SecurityHeaderTransport{Base: builtIn}
+	if platform {
+		builtIn = &auth.SecurityPolicyTransport{Base: builtIn}
+	}
+	return builtIn
 }
 
 type credentialDeps struct {

internal/cmdutil/factory_http_test.go

@@ -4,13 +4,20 @@
 package cmdutil
 
 import (
+	"errors"
 	"io"
+	"net/http"
+	"net/http/httptest"
+	"strings"
 	"testing"
 
+	"github.com/larksuite/cli/errs"
+	exttransport "github.com/larksuite/cli/extension/transport"
 	"github.com/larksuite/cli/internal/core"
+	internaltransport "github.com/larksuite/cli/internal/transport"
 )
 
-func TestCachedHttpClientFunc_ReturnsSameInstance(t *testing.T) {
+func TestCachedHTTPClientFunc_ReturnsSameInstance(t *testing.T) {
 	isEnabled := false
 	f, _, _, _ := TestFactory(t, &core.CliConfig{AppID: "test-app"})
 	f.IOStreams.ErrOut = io.Discard
@@ -33,7 +40,7 @@ func TestCachedHttpClientFunc_ReturnsSameInstance(t *testing.T) {
 	}
 }
 
-func TestCachedHttpClientFunc_HasTimeout(t *testing.T) {
+func TestCachedHTTPClientFunc_HasTimeout(t *testing.T) {
 	isEnabled := false
 	f, _, _, _ := TestFactory(t, &core.CliConfig{AppID: "test-app"})
 	f.IOStreams.ErrOut = io.Discard
@@ -44,7 +51,7 @@ func TestCachedHttpClientFunc_HasTimeout(t *testing.T) {
 	}
 }
 
-func TestCachedHttpClientFunc_HasRedirectPolicy(t *testing.T) {
+func TestCachedHTTPClientFunc_HasRedirectPolicy(t *testing.T) {
 	isEnabled := false
 	f, _, _, _ := TestFactory(t, &core.CliConfig{AppID: "test-app"})
 	f.IOStreams.ErrOut = io.Discard
@@ -54,3 +61,283 @@ func TestCachedHttpClientFunc_HasRedirectPolicy(t *testing.T) {
 		t.Error("expected CheckRedirect to be set (safeRedirectPolicy)")
 	}
 }
+
+func TestFactoryExternalHTTPClientClonesExistingClient(t *testing.T) {
+	base := &http.Client{Timeout: 17, CheckRedirect: safeRedirectPolicy}
+	factory := &Factory{HttpClient: func() (*http.Client, error) { return base, nil }}
+
+	external, err := factory.ExternalHTTPClient()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if external == base {
+		t.Fatal("ExternalHTTPClient returned the cached client instead of a clone")
+	}
+	if external.Timeout != base.Timeout || external.CheckRedirect == nil {
+		t.Fatal("ExternalHTTPClient did not preserve client policy")
+	}
+	if base.Transport != nil {
+		t.Fatal("ExternalHTTPClient mutated the cached client's transport")
+	}
+}
+
+type platformOnlyStubProvider struct {
+	*stubTransportProvider
+}
+
+func (*platformOnlyStubProvider) SupportsRequestClass(class exttransport.RequestClass) bool {
+	return class == exttransport.RequestClassPlatform
+}
+
+func TestFactoryHTTPClientRoutesPoliciesByRequestClass(t *testing.T) {
+	t.Setenv("LARKSUITE_CLI_NO_PROXY", "1")
+
+	interceptor := &headerCapturingInterceptor{}
+	exttransport.Register(&platformOnlyStubProvider{stubTransportProvider: &stubTransportProvider{interceptor: interceptor}})
+	t.Cleanup(func() { exttransport.Register(nil) })
+
+	received := make(chan http.Header, 2)
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
+		received <- req.Header.Clone()
+		w.WriteHeader(http.StatusNoContent)
+	}))
+	t.Cleanup(server.Close)
+
+	factory := &Factory{IOStreams: &IOStreams{ErrOut: io.Discard}}
+	client, err := cachedHttpClientFunc(factory, nil)()
+	if err != nil {
+		t.Fatal(err)
+	}
+	factory.HttpClient = func() (*http.Client, error) { return client, nil }
+	platformClient := internaltransport.ClientForRequestClass(client, exttransport.RequestClassPlatform)
+	externalClient, err := factory.ExternalHTTPClient()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	for _, client := range []*http.Client{platformClient, externalClient} {
+		resp, err := client.Get(server.URL)
+		if err != nil {
+			t.Fatal(err)
+		}
+		resp.Body.Close()
+	}
+
+	platformHeaders := <-received
+	if got := platformHeaders.Get("X-Custom-Trace"); got != "ext-trace-123" {
+		t.Fatalf("platform extension header = %q, want ext-trace-123", got)
+	}
+	if got := platformHeaders.Get(HeaderSource); got != SourceValue {
+		t.Fatalf("platform security header = %q, want %q", got, SourceValue)
+	}
+
+	externalHeaders := <-received
+	if got := externalHeaders.Get("X-Custom-Trace"); got != "" {
+		t.Fatalf("external request leaked extension header %q", got)
+	}
+	for header, values := range BaseSecurityHeaders() {
+		if len(values) == 0 {
+			continue
+		}
+		want := values[len(values)-1]
+		if got := externalHeaders.Get(header); got != want {
+			t.Fatalf("external security header %s = %q, want preserved value %q", header, got, want)
+		}
+	}
+}
+
+func TestFactoryExternalHTTPClientDoesNotParsePlatformErrorProtocol(t *testing.T) {
+	t.Setenv("LARKSUITE_CLI_NO_PROXY", "1")
+	exttransport.Register(nil)
+
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
+		w.Header().Set("Content-Type", "application/json")
+		_, _ = io.WriteString(w, `{"code":21000,"msg":"application-defined external response","data":{"cli_hint":"external-defined"}}`)
+	}))
+	t.Cleanup(server.Close)
+
+	factory := &Factory{IOStreams: &IOStreams{ErrOut: io.Discard}}
+	client, err := cachedHttpClientFunc(factory, nil)()
+	if err != nil {
+		t.Fatal(err)
+	}
+	factory.HttpClient = func() (*http.Client, error) { return client, nil }
+
+	platform := internaltransport.ClientForRequestClass(client, exttransport.RequestClassPlatform)
+	if _, err := platform.Get(server.URL); err == nil {
+		t.Fatal("platform request error = nil, want security policy classification")
+	} else {
+		var policyErr *errs.SecurityPolicyError
+		if !errors.As(err, &policyErr) {
+			t.Fatalf("platform request error type = %T, want *errs.SecurityPolicyError", err)
+		}
+	}
+
+	external, err := factory.ExternalHTTPClient()
+	if err != nil {
+		t.Fatal(err)
+	}
+	resp, err := external.Get(server.URL)
+	if err != nil {
+		t.Fatalf("external request parsed platform error protocol: %v", err)
+	}
+	resp.Body.Close()
+}
+
+func TestSafeRedirectPolicyAllowsBodylessCrossOriginGetAndStripsCredentials(t *testing.T) {
+	original, err := http.NewRequest(http.MethodGet, "https://open.feishu.cn/start", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodGet, "https://cdn.example.com/file", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	for _, header := range []string{"Authorization", "X-Lark-MCP-UAT", "X-Lark-MCP-TAT"} {
+		redirect.Header.Set(header, "secret")
+	}
+
+	if err := safeRedirectPolicy(redirect, []*http.Request{original}); err != nil {
+		t.Fatalf("safeRedirectPolicy() error = %v, want allowed GET redirect", err)
+	}
+	for _, header := range []string{"Authorization", "X-Lark-MCP-UAT", "X-Lark-MCP-TAT"} {
+		if got := redirect.Header.Get(header); got != "" {
+			t.Fatalf("redirect retained %s=%q", header, got)
+		}
+	}
+}
+
+func TestSafeRedirectPolicyRejectsHTTPSDowngrade(t *testing.T) {
+	original, err := http.NewRequest(http.MethodGet, "https://open.feishu.cn/start", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodGet, "http://open.feishu.cn/next", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	err = safeRedirectPolicy(redirect, []*http.Request{original})
+	if err == nil || !strings.Contains(err.Error(), "HTTPS") {
+		t.Fatalf("safeRedirectPolicy() error = %v, want HTTPS downgrade rejection", err)
+	}
+	requireRedirectProblem(t, err, errs.CategoryPolicy, errs.SubtypeAccessDenied)
+}
+
+func TestSafeRedirectPolicyRejectsCrossOriginMethod(t *testing.T) {
+	original, err := http.NewRequest(http.MethodPost, "https://accounts.feishu.cn/token", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodPost, "https://external.example/token", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	err = safeRedirectPolicy(redirect, []*http.Request{original})
+	if err == nil || !strings.Contains(err.Error(), "HTTP method POST") {
+		t.Fatalf("safeRedirectPolicy() error = %v, want cross-origin method rejection", err)
+	}
+	requireRedirectProblem(t, err, errs.CategoryPolicy, errs.SubtypeAccessDenied)
+}
+
+func TestSafeRedirectPolicyRejectsCrossOriginRequestBody(t *testing.T) {
+	original, err := http.NewRequest(http.MethodGet, "https://accounts.feishu.cn/token", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodGet, "https://external.example/token", strings.NewReader("client_secret=secret"))
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	err = safeRedirectPolicy(redirect, []*http.Request{original})
+	if err == nil || !strings.Contains(err.Error(), "request body") {
+		t.Fatalf("safeRedirectPolicy() error = %v, want cross-origin body rejection", err)
+	}
+	requireRedirectProblem(t, err, errs.CategoryPolicy, errs.SubtypeAccessDenied)
+}
+
+func TestSafeRedirectPolicyRejectsTooManyRedirects(t *testing.T) {
+	err := safeRedirectPolicy(&http.Request{}, make([]*http.Request, 10))
+	if err == nil || err.Error() != "too many redirects" {
+		t.Fatalf("safeRedirectPolicy() error = %v, want redirect limit rejection", err)
+	}
+	requireRedirectProblem(t, err, errs.CategoryNetwork, errs.SubtypeNetworkTransport)
+}
+
+func TestSafeRedirectPolicyTreatsDefaultHTTPSPortAsSameOrigin(t *testing.T) {
+	original, err := http.NewRequest(http.MethodPost, "https://accounts.feishu.cn/token", strings.NewReader("secret"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodPost, "https://accounts.feishu.cn:443/token-next", strings.NewReader("secret"))
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if err := safeRedirectPolicy(redirect, []*http.Request{original}); err != nil {
+		t.Fatalf("safeRedirectPolicy() error = %v, want same-origin redirect", err)
+	}
+}
+
+func TestSafeRedirectPolicyKeepsCredentialsStrippedAcrossExternalHops(t *testing.T) {
+	original, err := http.NewRequest(http.MethodGet, "https://open.feishu.cn/start", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	previous, err := http.NewRequest(http.MethodGet, "https://cdn.example.com/first", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodGet, "https://cdn.example.com/second", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect.Header.Set("Authorization", "Bearer copied-from-initial-request")
+
+	if err := safeRedirectPolicy(redirect, []*http.Request{original, previous}); err != nil {
+		t.Fatalf("safeRedirectPolicy() error = %v, want same-CDN redirect", err)
+	}
+	if got := redirect.Header.Get("Authorization"); got != "" {
+		t.Fatalf("redirect retained Authorization=%q outside the initial origin", got)
+	}
+}
+
+func TestSafeRedirectPolicyRejectsDowngradeOnLaterHop(t *testing.T) {
+	original, err := http.NewRequest(http.MethodGet, "http://source.example/start", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	previous, err := http.NewRequest(http.MethodGet, "https://cdn.example.com/secure", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	redirect, err := http.NewRequest(http.MethodGet, "http://cdn.example.com/plain", nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	err = safeRedirectPolicy(redirect, []*http.Request{original, previous})
+	if err == nil || !strings.Contains(err.Error(), "HTTPS") {
+		t.Fatalf("safeRedirectPolicy() error = %v, want later-hop HTTPS downgrade rejection", err)
+	}
+	requireRedirectProblem(t, err, errs.CategoryPolicy, errs.SubtypeAccessDenied)
+}
+
+func requireRedirectProblem(t *testing.T, err error, category errs.Category, subtype errs.Subtype) {
+	t.Helper()
+	problem, ok := errs.ProblemOf(err)
+	if !ok {
+		t.Fatalf("error type = %T, want typed error", err)
+	}
+	if problem.Category != category || problem.Subtype != subtype {
+		t.Fatalf(
+			"error category/subtype = %s/%s, want %s/%s",
+			problem.Category,
+			problem.Subtype,
+			category,
+			subtype,
+		)
+	}
+}

internal/cmdutil/factory_proxy_warn_test.go

@@ -34,9 +34,9 @@ var proxyWarnGateCases = []struct {
 	{"non-terminal stderr stays silent", false, 0},
 }
 
-// TestCachedHttpClientFunc_ProxyWarnGate verifies the http-client init path
+// TestCachedHTTPClientFunc_ProxyWarnGate verifies the HTTP client init path
 // invokes WarnIfProxied only when stderr is an interactive terminal.
-func TestCachedHttpClientFunc_ProxyWarnGate(t *testing.T) {
+func TestCachedHTTPClientFunc_ProxyWarnGate(t *testing.T) {
 	isEnabled := false
 	for _, tc := range proxyWarnGateCases {
 		t.Run(tc.name, func(t *testing.T) {

internal/cmdutil/testing_test.go

@@ -46,7 +46,7 @@ func TestTestFactory_ReplacesGlobals(t *testing.T) {
 		URL:  "/test",
 		Body: "ok",
 	})
-	// Use the stub via Factory HttpClient
+	// Use the stub via Factory HttpClient.
 	httpClient, err := f.HttpClient()
 	if err != nil {
 		t.Fatalf("HttpClient() error: %v", err)

internal/cmdutil/transport.go

@@ -4,14 +4,19 @@
 package cmdutil
 
 import (
-	"context"
 	"net/http"
 	"time"
 
-	exttransport "github.com/larksuite/cli/extension/transport"
 	"github.com/larksuite/cli/internal/transport"
 )
 
+var (
+	_ transport.RoundTripperDecorator = (*RetryTransport)(nil)
+	_ transport.RoundTripperDecorator = (*UserAgentTransport)(nil)
+	_ transport.RoundTripperDecorator = (*BuildHeaderTransport)(nil)
+	_ transport.RoundTripperDecorator = (*SecurityHeaderTransport)(nil)
+)
+
 // RetryTransport is an http.RoundTripper that retries on 5xx responses
 // and network errors. MaxRetries defaults to 0 (no retries).
 type RetryTransport struct {
@@ -27,6 +32,16 @@ func (t *RetryTransport) base() http.RoundTripper {
 	return transport.Fallback()
 }
 
+func (t *RetryTransport) BaseRoundTripper() http.RoundTripper {
+	return t.base()
+}
+
+func (t *RetryTransport) WithBaseRoundTripper(base http.RoundTripper) http.RoundTripper {
+	cloned := *t
+	cloned.Base = base
+	return &cloned
+}
+
 func (t *RetryTransport) delay() time.Duration {
 	if t.Delay > 0 {
 		return t.Delay
@@ -63,6 +78,19 @@ type UserAgentTransport struct {
 	Base http.RoundTripper
 }
 
+func (t *UserAgentTransport) BaseRoundTripper() http.RoundTripper {
+	if t.Base != nil {
+		return t.Base
+	}
+	return transport.Fallback()
+}
+
+func (t *UserAgentTransport) WithBaseRoundTripper(base http.RoundTripper) http.RoundTripper {
+	cloned := *t
+	cloned.Base = base
+	return &cloned
+}
+
 func (t *UserAgentTransport) RoundTrip(req *http.Request) (*http.Response, error) {
 	req = req.Clone(req.Context())
 	req.Header.Set(HeaderUserAgent, UserAgentValue())
@@ -73,14 +101,25 @@ func (t *UserAgentTransport) RoundTrip(req *http.Request) (*http.Response, error
 }
 
 // BuildHeaderTransport is an http.RoundTripper that force-writes the
-// X-Cli-Build header before every request. Used in the SDK transport chain,
-// where SecurityHeaderTransport is not installed, to prevent extensions from
-// tampering with the build classification. The direct HTTP chain is already
-// covered by SecurityHeaderTransport iterating BaseSecurityHeaders.
+// X-Cli-Build header before every request. It remains in the SDK transport
+// chain as a narrow defense-in-depth layer alongside SecurityHeaderTransport.
 type BuildHeaderTransport struct {
 	Base http.RoundTripper
 }
 
+func (t *BuildHeaderTransport) BaseRoundTripper() http.RoundTripper {
+	if t.Base != nil {
+		return t.Base
+	}
+	return transport.Fallback()
+}
+
+func (t *BuildHeaderTransport) WithBaseRoundTripper(base http.RoundTripper) http.RoundTripper {
+	cloned := *t
+	cloned.Base = base
+	return &cloned
+}
+
 func (t *BuildHeaderTransport) RoundTrip(req *http.Request) (*http.Response, error) {
 	req = req.Clone(req.Context())
 	req.Header.Set(HeaderBuild, DetectBuildKind())
@@ -103,6 +142,16 @@ func (t *SecurityHeaderTransport) base() http.RoundTripper {
 	return transport.Fallback()
 }
 
+func (t *SecurityHeaderTransport) BaseRoundTripper() http.RoundTripper {
+	return t.base()
+}
+
+func (t *SecurityHeaderTransport) WithBaseRoundTripper(base http.RoundTripper) http.RoundTripper {
+	cloned := *t
+	cloned.Base = base
+	return &cloned
+}
+
 // RoundTrip implements http.RoundTripper.
 func (t *SecurityHeaderTransport) RoundTrip(req *http.Request) (*http.Response, error) {
 	req = req.Clone(req.Context())
@@ -120,67 +169,3 @@ func (t *SecurityHeaderTransport) RoundTrip(req *http.Request) (*http.Response,
 	}
 	return t.base().RoundTrip(req)
 }
-
-// extensionMiddleware wraps the built-in transport chain with pre/post hooks.
-// The built-in chain always executes unless the extension is an
-// exttransport.AbortableInterceptor and its PreRoundTripE returns a non-nil
-// error; it cannot otherwise be skipped or overridden.
-//
-// The original request context is restored after the pre hook to prevent
-// extensions from tampering with cancellation, deadlines, or built-in values.
-// Cloning the request isolates header/URL/etc. mutations from the caller's
-// request object; req.Body is intentionally shared — extensions that consume
-// it are responsible for rewinding (see Interceptor doc).
-type extensionMiddleware struct {
-	Base    http.RoundTripper
-	Ext     exttransport.Interceptor
-	ExtName string // Provider.Name(), captured at wrap time for *AbortError.Extension
-}
-
-// RoundTrip invokes the interceptor pre hook, restores the original context,
-// executes the built-in chain (unless aborted), then calls the post hook if
-// non-nil. When the extension implements AbortableInterceptor and returns a
-// non-nil error from PreRoundTripE, the built-in chain is skipped and an
-// *exttransport.AbortError is returned; the post hook is still invoked with
-// (nil, reason) so extensions can unwind resources.
-func (m *extensionMiddleware) RoundTrip(req *http.Request) (*http.Response, error) {
-	origCtx := req.Context()
-	req = req.Clone(origCtx)
-
-	var (
-		post    func(*http.Response, error)
-		abortEr error
-	)
-	if a, ok := m.Ext.(exttransport.AbortableInterceptor); ok {
-		post, abortEr = a.PreRoundTripE(req)
-	} else {
-		post = m.Ext.PreRoundTrip(req)
-	}
-	if abortEr != nil {
-		if post != nil {
-			post(nil, abortEr)
-		}
-		return nil, &exttransport.AbortError{Extension: m.ExtName, Reason: abortEr}
-	}
-
-	req = req.WithContext(origCtx) // restore original context
-	resp, err := m.Base.RoundTrip(req)
-	if post != nil {
-		post(resp, err)
-	}
-	return resp, err
-}
-
-// wrapWithExtension wraps transport with the registered extension middleware.
-// If no extension is registered, returns transport unchanged.
-func wrapWithExtension(transport http.RoundTripper) http.RoundTripper {
-	p := exttransport.GetProvider()
-	if p == nil {
-		return transport
-	}
-	tr := p.ResolveInterceptor(context.Background())
-	if tr == nil {
-		return transport
-	}
-	return &extensionMiddleware{Base: transport, Ext: tr, ExtName: p.Name()}
-}