feat(agent-kit): add @tigrisdata/agent-kit composition library

[designcode]

Summary

• Adds @tigrisdata/agent-kit — a composition library that bridges @tigrisdata/storage and @tigrisdata/iam into higher-level workflows for AI agent use cases
• Sandboxes: createSandbox(baseBucket, count, options?) / teardownSandbox(sandbox) — snapshot + fork N times + scoped credentials per fork
• Workspaces: createWorkspace(name, options?) / teardownWorkspace(workspace) — bucket + TTL + scoped credentials in one call
• Checkpoints: checkpoint(bucket) / restore(bucket, snapshotId) / listCheckpoints(bucket) — snapshot-based state management
• Coordination: setupCoordination(bucket, options) / teardownCoordination(bucket) — event-driven multi-agent pipelines via bucket notifications
• 10 integration tests covering all workflows
• Zero framework coupling — pure async TypeScript functions

Test plan

• npm run build — all packages build cleanly
• npm run lint — no lint errors
• npm run format:check — all files formatted
• npm test — 206 tests passing across all packages (114 storage + 10 agent-kit + 38 keyv-tigris + 44 react)
• Review API surface and function signatures
• Review README usage examples

🤖 Generated with Claude Code

---

Note

Low Risk
Low risk: this PR only updates documentation and does not change runtime code or APIs.

Overview
Updates the root README.md to include @tigrisdata/agent-kit in the monorepo’s package list, briefly describing it as an AI-agent workflow composition library.

^{Reviewed by Cursor Bugbot for commit 88e6170. Bugbot is set up for automated code reviews on this repo. Configure here.}

[greptile-apps]

Greptile Summary

This PR introduces @tigrisdata/ai, a new composition library that wraps @tigrisdata/storage and @tigrisdata/iam into higher-level workflows (sandboxes, workspaces, checkpoints, coordination) for AI agent use cases. The package structure, config layer, coordination module, and tests are solid, but three resource-management issues in workspace.ts, sandbox.ts, and checkpoint.ts need attention before merge:

• workspace.ts: A setBucketTtl failure is silently swallowed — the function returns success with no indication TTL was never applied. Callers expecting data auto-expiry will be silently misconfigured.
• workspace.ts / sandbox.ts: createAccessKey errors are not checked; credentials are silently omitted from the returned object with no error signal.
• sandbox.ts: When fork creation fails mid-loop, already-created fork buckets and IAM keys are abandoned without cleanup, leaking resources.

Confidence Score: 4/5

Do not merge until the three P1 error-handling gaps are fixed — they silently leak resources and return incorrect data to callers.

Three P1 findings: TTL failure swallowed, credential failure swallowed (in both workspace and sandbox), and orphaned fork buckets on partial failure. The rest of the package is well-structured.

packages/ai/src/workspace.ts and packages/ai/src/sandbox.ts require the most attention; packages/ai/src/checkpoint.ts has one smaller P1 fix needed.

Important Files Changed

Filename	Overview
packages/ai/src/sandbox.ts	New file: createSandbox has two issues — partial fork failures leak already-created buckets/keys, and credential creation errors are silently swallowed.
packages/ai/src/workspace.ts	New file: TTL configuration failure is silently swallowed (success returned without TTL), and credential creation failure is silently dropped with no error signal.
packages/ai/src/checkpoint.ts	New file: listCheckpoints maps missing snapshot versions to empty string, which will cause silent failures if passed to restore(); otherwise correct.
packages/ai/src/coordination.ts	New file: clean thin wrapper around setBucketNotifications with proper error handling; no issues found.
packages/ai/test/integration.test.ts	New file: 10 integration tests covering all four workflows; uses skipIf guard for missing credentials and cleans up resources in afterEach.

_{Reviews (1): Last reviewed commit: "refactor(ai): promote primary args to po..." | Re-trigger Greptile}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

There are 3 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit afb645c. Configure here.}

[github-actions]

🎉 This PR is included in version 0.1.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 3.2.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀