প্রকল্প সম্পর্কে

core-agent হল Google-এর Agent Development Kit (ADK)-এর উপর নির্মিত মাল্টি-টার্ন LLM এজেন্টের জন্য একটি প্রোডাকশন-গ্রেড Go সাবস্ট্রেট। এটি মৌলিক ওয়্যারিং — প্রোভাইডার, MCP, স্কিল, পারমিশন, স্থায়ী সেশন, রিমোট অ্যাটাচ, একটি ইন-প্রসেস Bubble Tea TUI এবং একটি হেডলেস CLI — সরবরাহ করে, যাতে ডাউনস্ট্রিম প্রকল্পগুলি তাদের নিজস্ব টুল এবং প্রোডাক্ট লজিকে ফোকাস করতে পারে। **রানটাইম**: ADK-এর রানার-এর মাধ্যমে মাল্টি-টার্ন কথোপকথন, সমান্তরাল টুল-কল ডিসপ্যাচ সহ। ডিফল্ট TTY সারফেস হিসেবে একটি ইন-প্রসেস Bubble Tea TUI, একটি --no-tui লাইন REPL ফলব্যাক এবং একটি স্লিম বিল্ড ট্যাগ যা TUI ট্রি বাদ দেয়। অটোনোমাস মোড টার্ন/টোকেন/কস্ট/ওয়ালক্লক বাজেট, মডেল-চালিত সমাপ্তি এবং স্থায়ী চেকপয়েন্টের মাধ্যমে ক্র্যাশ রিকভারি সহ আনঅ্যাটেন্ডেড ওয়ার্কার সাপোর্ট করে। দীর্ঘ-সেশন টিকে থাকার বৈশিষ্ট্যগুলির মধ্যে রয়েছে ~85% ব্যবহারে স্বয়ংক্রিয় পোস্ট-টার্ন কনটেক্সট কমপ্যাকশন, সাবটাস্ক যা এজেন্টিক টুল র্যাপার সহ প্যারেন্ট কনটেক্সট থেকে বাল্ক টুল আউটপুট বাইরে রাখে এবং টাস্ক-বাউন্ডারি চেকপয়েন্ট। **প্রোভাইডার**: Gemini API এবং Vertex AI (সার্ভার-সাইড GoogleSearch এবং URLContext সহ), api.anthropic.com-এর মাধ্যমে এবং Vertex AI-এর মাধ্যমে নেটিভ মডেল অ্যাডাপ্টার হিসেবে Anthropic Claude। মক প্রোভাইডার (echo, স্ক্রিপ্টেড JSONL রিপ্লে, সেশন রেকর্ডিং) ক্রেডেনশিয়াল-মুক্ত টেস্টিং সক্ষম করে। সার্ভার-সাইড বিল্ট-ইন টুল (web_search, url_context, code_execution) এর জন্য একটি প্রোভাইডার-নিরপেক্ষ থ্রি-স্টেট গেটিং সিস্টেম ইন্টারনেট-রিচেবিলিটি পোস্টার প্রোভাইডার সুইচে টিকে থাকতে দেয়। **নির্দেশনা, টুল, MCP, স্কিল**: AGENTS.md প্রাথমিক নির্দেশনা একটি ওভারলে ডিরেক্টরি সহ, মাল্টি-ফাইল কম্পোজিশনের জন্য @include ডিরেক্টিভ এবং তিনটি স্কোপ (user, user-home, project) CLAUDE.md/GEMINI.md ফলব্যাক সহ। বিল্ট-ইন টুল ক্যাটালগ ফাইল অপারেশন (read, write, edit, delete, outline), সার্চ (glob, grep), ডেটা/নেটওয়ার্ক (json_query, fetch_url), শেল (bash), প্ল্যানিং (todo, record_plan), ভেরিফিকেশন (wait_and_verify) এবং ইন্টারঅ্যাকটিভ প্রম্পটিং (ask_user) কভার করে। MCP সার্ভার mcp.json-এ stdio এবং Streamable HTTP ট্রান্সপোর্ট, নেমস্পেসড টুল এবং পারমিশন-গেটেড রাউটিং সহ ঘোষিত। ক্লড-সামঞ্জস্যপূর্ণ স্কিল SKILL.md ফাইল থেকে স্বয়ংক্রিয়ভাবে আবিষ্কৃত হয় প্রয়োজনীয়তা ঘোষণা সহ (যেমন, shell, kubectl, gcloud) যা স্টার্টআপে পূরণ না হলে আটকে রাখা হয়। **পারমিশন**: ask/allow/yolo মোড প্যাটার্ন-ভিত্তিক allow/deny তালিকা সহ, ফাইল টুলে পাথ-স্কোপ প্রয়োগ, fetch_url-এর জন্য URL-স্কোপ অ্যালোলিস্ট এবং একটি নন-ওভাররাইডেবল bash ডেনিলিস্ট। প্ল্যান-ফার্স্ট এনফোর্সমেন্ট মিউটেটিং টুল কলের আগে একটি রেকর্ড করা প্ল্যান প্রয়োজন করতে পারে (প্রয়োজনীয় মোড) বা ব্লক না করে প্ল্যান রেকর্ড করতে পারে (আনঅ্যাটেন্ডেড রানের জন্য অ্যাডভাইজরি মোড)। প্লাগেবল Prompter ইন্টারফেস TTY, হেডলেস, TUI বা কাস্টম ওয়েব ফ্রন্টএন্ড জুড়ে কাজ করে। **স্থায়ীত্ব ও পর্যবেক্ষণযোগ্যতা**: SQLite (পিওর-গো, CGO-মুক্ত), Postgres বা MySQL-এর মাধ্যমে স্থায়ী সেশন এবং অডিট লগ মনোটোনিক seq, রিপ্লে, লাইভ-টেইল ওয়াচ এবং ক্র্যাশ-নিরাপদ মাল্টি-প্রসেস রিজিউমের জন্য সেশন লকিং সহ। ঐচ্ছিক OpenTelemetry এক্সপোর্ট (console/OTLP, ডিফল্ট বন্ধ)। লেয়ারড প্রাইসিং সহ প্রতি-মডেল টোকেন এবং খরচ ট্র্যাকিং (দৈনিক LiteLLM রিফ্রেশ, প্রতি-কনফিগ ওভাররাইড)। **রিমোট অ্যাটাচ ও অপারেটর সারফেস**: mTLS + bearer auth-এর উপর HTTP + SSE লাইভ-টেইল inject/wake এন্ডপয়েন্ট সহ। ইন-ফ্লাইট টার্ন বাতিল এবং লুপ পার্কিংয়ের জন্য অপারেটর hold/interrupt/pause নিয়ন্ত্রণ। রিমোট TUI ক্লায়েন্ট (আলাদাভাবে-ভার্সনযুক্ত বাইনারি) সম্পূর্ণ স্ল্যাশ-কমান্ড প্যারিটি, প্রতি-টার্ন খরচ ফুটার, লাইভ টুল-অনুমোদন মডেল এবং সেশন স্যুইচিং সহ। মাল্টি-সেশন ডেমন প্রতি-কলার আইডেন্টিটি, ACL (Owner/Viewers/Contributors), পারমিশন গ্রান্ট, নির্দেশনা ওভারলে এবং অডিট অ্যাট্রিবিউশন সহ; সেশন ডেমন রিস্টার্টে টিকে থাকে। A2A AgentCard আকারে /.well-known/agent-card.json-এর মাধ্যমে এজেন্ট-কার্ড ডিসকভারি। হাব-এন্ড-স্পোক ফ্লিট ডিসকভারির জন্য পিয়ার রেজিস্ট্রেশন। **সাবএজেন্ট**: agent.WithSubagents-এর মাধ্যমে ইন-প্রসেস সিঙ্ক্রোনাস ডেলিগেশন, spawn_agent/stop_agent-এর মাধ্যমে ব্যাকগ্রাউন্ড সাবএজেন্ট যার ফলাফল Background রিপোর্ট হিসেবে পুশ ব্যাক করা হয়। কনজিউমার-সাপ্লাইড RemoteAgentSpawner-এর মাধ্যমে gRPC, K8s Jobs বা Cloud Run-এর জন্য রিমোট স্পনিং। সাবএজেন্ট ইভেন্ট Branch লেবেলের অধীনে প্যারেন্টের অডিট লগে স্ট্রিম হয়। **Kubernetes Triage Sidecar**: lookout-watch Kubernetes Events দেখে, ফিল্টার এবং ডিডুপ করে এবং GKE MCP-এর মাধ্যমে diagnose-fix-verify লুপের জন্য প্রতি-ইনসিডেন্ট সেশনে মিলে যাওয়া ঘটনা ইনজেক্ট করে, প্ল্যান-ফার্স্ট এনফোর্সমেন্ট দ্বারা গেটেড। **ইনস্টলেশন**: Go install (Go 1.26+ প্রয়োজন), প্রি-বিল্ট Sigstore-স্বাক্ষরিত বাইনারি (linux/darwin × amd64/arm64) এবং মাল্টি-আর্ক ডিস্ট্রোলেস কন্টেইনার ইমেজ (ফুল ডেমন+TUI, স্লিম হেডলেস, শুধুমাত্র TUI ক্লায়েন্ট)। লাইসেন্স Apache-2.0।