postgrip-io/agent-sdk-go

PostGrip Agent の Go SDK で、PostGrip エージェント実行時サービスとやり取りするためのクライアント／ワーカー実装を提供します。TypeScript/Python SDK とプロトコルを共有するため、ポリグロット環境で言語ごとに適切なランタイムを選べます。主にエージェントにタスクを登録・起動するクライアント（task/workflow/schedule 操作）、エージェント上でポーリングしてタスクをリース・分配する Worker、ワークフロー実行モデル（耐久的な履歴・決定論的リプレイ）やアクティビティ実行用のユーティリティを提供します。 利用者: Go でワーカーやワークフロー、アクティビティを実装する開発者。 主な機能: - client パッケージ: タスク登録（ShellExec/ContainerExec/Enqueue/Noop）、ワークフロー開始やハンドル、スケジュール管理API - worker パッケージ: ポーリング、リース、noop/activity/workflow タスクのディスパッチ - workflow/activity パッケージ: ワークフローコンテキスト、シグナル/クエリ/アップデート、アクティビティ関数、ハートビート・マイルストーン - failure パッケージ: 構造化された失敗型（Application/Cancelled/Timeout 等） - ワークフローは履歴に基づく決定論的リプレイ、依存解決でのサスペンド/再実行、決定論違反検出をサポート ドキュメントと自動生成 API（pkg.go.dev、GitHub Pages）あり。注意点として container.exec は DOCKER_HOST 設定やネットワーク/ボリューム制限、環境変数の許可リストなどの実行制約があります。