feat(tarko): add workspace display in navbar (close: #1039)

[ulivz]

Summary

Adds workspace directory display in navbar. Shows current working directory as a green badge with folder icon.

What's added:

• /api/v1/agent/options endpoint for workspace info
• Workspace badge in navbar (📁 + directory name)
• Auto-truncation for long paths with hover tooltip
• Sanitized config exposure (masks sensitive data)

UI:
Workspace badge appears before Agent/Model badges with green gradient theme.

🔧 Recent Improvements (Latest Commits)

Fixed Design Issues & Centralized Types

Problems Resolved:

• ❌ Created duplicate custom interfaces instead of using existing AgentOptions types
• ❌ Missing many important AgentOptions fields
• ❌ Incorrect tool serialization logic (tried to exclude non-existent handler instead of function)
• ❌ Type definitions scattered across packages causing duplication

Solutions Implemented:

1. Centralized Type Management

   • ✅ Moved shared types to @tarko/interface: SanitizedAgentOptions, SanitizedTool, WorkspaceInfo
   • ✅ Eliminated duplicate definitions between server and web-ui packages
   • ✅ Single source of truth for client-server communication types

2. Complete AgentOptions Support

   • ✅ Support all AgentOptions fields: id, name, instructions, model, maxTokens, temperature, thinking, tools, tool, toolCallEngine, maxIterations, context, eventStreamOptions, enableStreamingToolCallEvents, logLevel, workspace
   • ✅ Added workspaceName field for UI display
   • ✅ Proper ToolCallEngineType serialization to string

3. Correct Tool Serialization

   • ✅ Fix tool serialization by excluding function property (not non-existent handler)
   • ✅ Preserve all tool metadata: name, description, schema
   • ✅ Type-safe SanitizedTool interface

4. Architecture Improvement

   Before:
   ┌─────────────────┐    ┌─────────────────┐
   │   agent-server  │    │  agent-web-ui   │
   │ Custom types    │    │ Custom types    │  ❌ Duplication
   │ (incomplete)    │    │ (inconsistent)  │
   └─────────────────┘    └─────────────────┘
   
   After:
   ┌─────────────────────────────────────────┐
   │              @tarko/interface           │
   │ SanitizedAgentOptions, SanitizedTool,   │  ✅ Single source
   │ WorkspaceInfo                           │
   └─────────────────────────────────────────┘
              ▲                    ▲
              │                    │
   ┌─────────────────┐    ┌─────────────────┐
   │   agent-server  │    │  agent-web-ui   │
   │ Uses shared     │    │ Uses shared     │
   │ types           │    │ types           │
   └─────────────────┘    └─────────────────┘
   

🧪 Testing

• ✅ All packages build successfully
• ✅ TypeScript compilation passes
• ✅ Type safety maintained
• ✅ Backward compatibility preserved

Closes #1039

Checklist

• Added or updated necessary tests (Optional).
• Updated documentation to align with changes (Optional).
• Verified no breaking changes, or prepared solutions for any occurring breaking changes (Optional).
• My change does not involve the above items.

[netlify]

✅ Deploy Preview for agent-tars-docs ready!

Name	Link
🔨 Latest commit	570f7ee
🔍 Latest deploy log	https://app.netlify.com/projects/agent-tars-docs/deploys/689a5aa5d8233c00084655b3
😎 Deploy Preview	https://deploy-preview-1081--agent-tars-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.