@cohortapp/agent-sdk 2.3.0

package/workflows/continuous/backlog-executor.yaml

@@ -0,0 +1,141 @@
+# Backlog Executor — Continuous Execution Loop
+# Runs every 10 minutes via launchd
+# This is the "getting shit done" engine — items move from open → resolved → closed
+
+name: backlog-executor
+type: continuous
+schedule: "*/10 * * * *"
+timezone: Asia/Dubai
+description: >
+  The core execution engine. Every 10 minutes: check quota, read all queues,
+  select top actionable items, spawn parallel agents to execute, review results,
+  update queues. Items continuously move forward — not sitting in queues.
+
+steps:
+  # ── Gate: Check API quota before spawning agents ──
+  - id: quota-gate
+    skill: claude-pace
+    action: check-quota-headroom
+    description: >
+      Check Claude API rate limit quota before spawning parallel agents.
+      Determines execution batch size based on pace delta zone.
+    timeout: 30
+    outputs:
+      pace_delta: green|yellow|red
+      max_parallel_agents: 5|2|1
+      recommendation: proceed|reduce|critical-only
+    on_result:
+      green:
+        max_parallel: 5
+        include_improvement_backlog: true
+      yellow:
+        max_parallel: 2
+        include_improvement_backlog: false
+      red:
+        max_parallel: 1
+        include_improvement_backlog: false
+        skip_non_critical: true
+
+  # ── Read all queues and select actionable items ──
+  - id: queue-scan
+    agent: pmo-execution
+    action: scan-all-queues
+    description: Read all 15 operational queues, select top actionable items by priority
+    timeout: 120
+    depends_on: [quota-gate]
+    inputs:
+      queues_dir: state/queues/
+      max_items: "{quota-gate.outputs.max_parallel_agents}"
+      include_improvement_backlog: "{quota-gate.outputs.on_result.include_improvement_backlog}"
+      status_filter: [open, in_progress, blocked]
+      sort_by: [priority, sla_deadline, created_at]
+    outputs:
+      selected_items: []
+      queue_summary: {}
+
+  # ── Spawn parallel execution agents ──
+  - id: parallel-execution
+    agent: session-spawner
+    action: spawn-execution-agents
+    description: >
+      Spawn one background agent per selected item. Each agent gets full context
+      and executes independently. Quota-gated parallelism.
+    timeout: 1800 # 30 minutes max for the batch
+    depends_on: [queue-scan]
+    inputs:
+      items: "{queue-scan.outputs.selected_items}"
+      max_concurrent: "{quota-gate.outputs.max_parallel_agents}"
+      mode: background
+    outputs:
+      agent_sessions: []
+      results: []
+
+  # ── Monitor running agents (if agents-observe is active) ──
+  - id: agent-monitoring
+    skill: agents-observe
+    action: monitor-parallel-execution
+    description: >
+      Monitor spawned agents for failures, hangs, or resource contention.
+      Only runs if agents-observe dashboard is active — otherwise skipped.
+    timeout: 60
+    depends_on: [parallel-execution]
+    optional: true # Skip if agents-observe is not running
+    inputs:
+      session_ids: "{parallel-execution.outputs.agent_sessions}"
+      check_for: [hung_agents, error_patterns, resource_contention]
+    outputs:
+      health_report: {}
+      failed_agents: []
+
+  # ── Review results and update queues ──
+  - id: results-review
+    agent: pmo-execution
+    action: review-execution-results
+    description: >
+      Review agent outputs, update queue item statuses, mark completed items
+      as resolved, flag failures for investigation.
+    timeout: 120
+    depends_on: [parallel-execution, agent-monitoring]
+    inputs:
+      results: "{parallel-execution.outputs.results}"
+      health_report: "{agent-monitoring.outputs.health_report}"
+      failed_agents: "{agent-monitoring.outputs.failed_agents}"
+    outputs:
+      items_resolved: []
+      items_failed: []
+      items_requeued: []
+
+  # ── Update executive summary ──
+  - id: dashboard-update
+    agent: pmo-execution
+    action: update-executive-summary
+    description: Refresh executive summary dashboard with cycle results
+    timeout: 60
+    depends_on: [results-review]
+    inputs:
+      resolved: "{results-review.outputs.items_resolved}"
+      failed: "{results-review.outputs.items_failed}"
+      requeued: "{results-review.outputs.items_requeued}"
+      dashboard: state/dashboards/executive-summary.yaml
+
+  # ── Log cycle ──
+  - id: cycle-log
+    action: log
+    description: Append cycle summary to backlog executor log
+    depends_on: [dashboard-update]
+    inputs:
+      file: logs/workflows/{date}-backlog-executor.jsonl
+      data:
+        cycle_time: "{timestamp}"
+        pace_delta: "{quota-gate.outputs.pace_delta}"
+        items_selected: "{queue-scan.outputs.selected_items.length}"
+        items_resolved: "{results-review.outputs.items_resolved.length}"
+        items_failed: "{results-review.outputs.items_failed.length}"
+
+on_failure:
+  action: log-and-notify
+  message: "Backlog executor cycle failed at step {failed_step}"
+  notify: agent-self # the executing agent (operator)
+  severity: high
+  # If quota-gate fails, the entire cycle is skipped — this is by design
+  quota_gate_failure: skip_cycle

package/workflows/continuous/inbound-monitor.yaml

@@ -0,0 +1,168 @@
+# Continuous Inbound Monitoring Loop
+# Runs perpetually via launchd — polls all channels and dispatches responses
+# This is the heartbeat of the agent's always-on executive operations
+
+name: inbound-monitor
+type: continuous # Not scheduled — runs as a persistent loop
+description: >
+  Perpetual monitoring loop across Slack, WhatsApp, and Gmail.
+  Detects new inbound messages, classifies them, and routes to
+  the appropriate response path.
+
+# Monitoring configuration
+monitors:
+  slack:
+    agent: slack-operator
+    mode: observe
+    interval_seconds: 60
+    scope:
+      - type: mentions
+        description: Any @mention of the agent or the principal
+      - type: dms
+        description: All direct messages
+      - type: channels
+        source: config/slack-channels.yaml
+        description: Priority channels only
+    detection:
+      method: screenshot-diff # Compare screenshots to detect new messages
+      fallback: timestamp-check # Compare last-seen timestamp
+    output: outputs/inbound/queue/slack-{timestamp}.yaml
+
+  gmail:
+    agent: gmail-operator
+    mode: observe
+    interval_seconds: 120
+    scope:
+      - type: unread
+        description: All unread messages in inbox
+      - type: priority
+        source: config/contacts.yaml
+        description: Messages from priority senders surfaced first
+    detection:
+      method: unread-count-diff # Detect new unread messages
+    output: outputs/inbound/queue/gmail-{timestamp}.yaml
+
+  whatsapp:
+    agent: whatsapp-operator
+    mode: observe
+    interval_seconds: 120
+    scope:
+      - type: business
+        description: Business-tagged contacts only
+        source: config/contacts.yaml
+      - type: unread
+        description: Any unread messages in business chats
+    detection:
+      method: screenshot-diff
+    output: outputs/inbound/queue/whatsapp-{timestamp}.yaml
+
+# Dispatch configuration
+dispatch:
+  agent: inbound-dispatcher
+  interval_seconds: 30 # Check queue every 30 seconds
+  input: outputs/inbound/queue/
+  classification_output: outputs/inbound/classified/
+
+  routing:
+    direct-reply:
+      handler: agent-self # the executing agent (operator)
+      description: The agent handles directly — default route for most inbound
+      max_response_time: 120 # 2 minutes for DMs, 5 minutes for channels
+      priority: highest
+
+    spawn-session:
+      handler: session-spawner
+      description: Spawn dedicated Claude Code session for complex work
+      output: outputs/sessions/
+      max_concurrent: 5
+
+    escalate-to-ceo:
+      handler: agent-self # the executing agent (operator)
+      description: >
+        Alert the principal only for binding commitments, regulatory submissions,
+        deal terms, or genuinely strategic decisions. The agent decides when this applies.
+      method: slack-dm # DM the principal on Slack
+      fallback: whatsapp # If Slack unavailable, WhatsApp
+
+    defer:
+      handler: pmo-execution
+      description: Add to next scheduled triage (low-priority items only)
+      output: outputs/inbound/deferred/
+
+# Autonomous response rules
+# The agent is fully autonomous — she responds to all inbound communications
+# using her own judgement as Chief of Staff. No per-message approval gates.
+autonomous_response:
+  enabled: true
+  mode: full_autonomy # The agent decides what to send and when
+  categories:
+    - id: dm-response
+      description: Respond to any DM from any workspace user
+      channels: [slack]
+      scope: all_users # Not limited to known contacts
+      approval: autonomous
+      response_time_target: 120 # 2 minutes for DMs
+      log: true
+
+    - id: channel-response
+      description: Respond to mentions and relevant messages in monitored channels
+      channels: [slack]
+      scope: monitored_channels
+      approval: autonomous
+      response_time_target: 300 # 5 minutes for channel messages
+      log: true
+
+    - id: email-response
+      description: Respond to all inbound email
+      channels: [gmail]
+      scope: all_senders
+      approval: autonomous
+      response_time_target: 900 # 15 minutes for email
+      log: true
+
+    - id: whatsapp-response
+      description: Respond to WhatsApp messages from business contacts
+      channels: [whatsapp]
+      scope: business_contacts
+      approval: autonomous
+      response_time_target: 300
+      log: true
+
+    - id: calendar-management
+      description: Accept, decline, reschedule calendar invitations
+      channels: [gmail, google-calendar]
+      approval: autonomous
+      log: true
+
+    - id: proactive-followup
+      description: Initiate follow-ups on open loops without being prompted
+      channels: [slack, gmail, whatsapp]
+      source: outputs/followups/
+      approval: autonomous
+      log: true
+
+    - id: status-update
+      description: Provide status updates on any tracked workstream
+      channels: [slack, gmail]
+      scope: all_contacts
+      source: knowledge/memory/executive-memory.yaml
+      approval: autonomous
+      log: true
+
+# Emergency stop integration
+emergency_stop:
+  check_file: .emergency-stop
+  check_interval: 10 # Check every 10 seconds
+  on_stop: halt-all-monitors
+
+# Health reporting
+health:
+  report_interval: 300 # Report health every 5 minutes
+  output: logs/monitor-health.log
+  metrics:
+    - messages_detected
+    - messages_classified
+    - auto_responses_sent
+    - sessions_spawned
+    - escalations_triggered
+    - errors

package/workflows/daily/applicant-triage.yaml

@@ -0,0 +1,197 @@
+# Daily Applicant Triage
+# Runs daily at 09:00 GST (UTC+4)
+# Checks for new applications, AI screens, classifies, and drafts responses
+
+name: applicant-triage
+schedule: "0 9 * * *" # 09:00 daily
+timezone: Asia/Dubai
+description: >
+  Daily triage of incoming job applications across all channels. AI screens
+  new candidates, classifies them (advance / hold / close), drafts appropriate
+  responses, and queues correspondence for approval.
+
+steps:
+  - id: scan-linkedin-applications
+    agent: hiring-org-design
+    action: scan-channel-applications
+    description: Check for new applications received via LinkedIn
+    timeout: 300
+    inputs:
+      channel: linkedin
+      source: ~/hr-system/applications/linkedin/
+      since: last_24_hours
+    outputs:
+      file: outputs/briefs/daily/{date}/applicants-linkedin.md
+
+  - id: scan-website-applications
+    agent: hiring-org-design
+    action: scan-channel-applications
+    description: Check for new applications received via the company website
+    timeout: 300
+    parallel_with: scan-linkedin-applications
+    inputs:
+      channel: website
+      source: ~/hr-system/applications/website/
+      since: last_24_hours
+    outputs:
+      file: outputs/briefs/daily/{date}/applicants-website.md
+
+  - id: scan-email-applications
+    agent: hiring-org-design
+    action: scan-channel-applications
+    description: Check for new applications received via email
+    timeout: 300
+    parallel_with: scan-linkedin-applications
+    inputs:
+      channel: email
+      source: ~/hr-system/applications/email/
+      since: last_24_hours
+    outputs:
+      file: outputs/briefs/daily/{date}/applicants-email.md
+
+  - id: consolidate-new-applicants
+    agent: hiring-org-design
+    action: consolidate-applicants
+    description: Merge all new applications into a single candidate list with deduplication
+    timeout: 180
+    depends_on:
+      [
+        scan-linkedin-applications,
+        scan-website-applications,
+        scan-email-applications,
+      ]
+    inputs:
+      sources:
+        - outputs/briefs/daily/{date}/applicants-linkedin.md
+        - outputs/briefs/daily/{date}/applicants-website.md
+        - outputs/briefs/daily/{date}/applicants-email.md
+    outputs:
+      file: outputs/briefs/daily/{date}/new-applicants-consolidated.md
+
+  - id: ai-screen-candidates
+    agent: hiring-org-design
+    action: ai-screen-candidates
+    description: Run AI screening on all new candidates — score 0-100 on role fit
+    timeout: 600
+    depends_on: [consolidate-new-applicants]
+    inputs:
+      candidates: outputs/briefs/daily/{date}/new-applicants-consolidated.md
+      job_descriptions: ~/hr-system
+      screening_config:
+        advance_threshold: 75
+        reject_threshold: 40
+    outputs:
+      file: outputs/briefs/daily/{date}/screening-scores.md
+
+  - id: classify-candidates
+    agent: hiring-org-design
+    action: classify-screened-candidates
+    description: >
+      Classify candidates into three categories:
+      advance (>= 75), hold for review (40-74), close off (< 40)
+    timeout: 180
+    depends_on: [ai-screen-candidates]
+    inputs:
+      screening_results: outputs/briefs/daily/{date}/screening-scores.md
+      config: config/hiring.yaml
+    outputs:
+      file: outputs/briefs/daily/{date}/candidate-classification.md
+
+  - id: draft-advance-responses
+    agent: hiring-org-design
+    action: draft-suitable-candidate-responses
+    description: Draft warm outreach for candidates advancing to next stage
+    timeout: 300
+    depends_on: [classify-candidates]
+    inputs:
+      classification: outputs/briefs/daily/{date}/candidate-classification.md
+      category: advance
+      tone: warm_professional
+      voice: agent
+      sla: 24h
+    outputs:
+      file: outputs/comms/hiring/{date}/daily-advance-drafts.md
+
+  - id: draft-hold-responses
+    agent: hiring-org-design
+    action: draft-hold-responses
+    description: Draft acknowledgement messages for candidates held for hiring manager review
+    timeout: 300
+    parallel_with: draft-advance-responses
+    depends_on: [classify-candidates]
+    inputs:
+      classification: outputs/briefs/daily/{date}/candidate-classification.md
+      category: hold
+      tone: professional
+      voice: agent
+    outputs:
+      file: outputs/comms/hiring/{date}/daily-hold-drafts.md
+
+  - id: draft-rejection-responses
+    agent: hiring-org-design
+    action: draft-rejection-responses
+    description: Draft gentle, kind rejection messages for candidates being closed off
+    timeout: 300
+    parallel_with: draft-advance-responses
+    depends_on: [classify-candidates]
+    inputs:
+      classification: outputs/briefs/daily/{date}/candidate-classification.md
+      category: reject
+      tone: kind_encouraging
+      voice: agent
+      sla: 48h
+    outputs:
+      file: outputs/comms/hiring/{date}/daily-rejection-drafts.md
+
+  - id: queue-for-approval
+    agent: hiring-org-design
+    action: queue-correspondence-approval
+    description: Queue all drafted responses for communications approval flow
+    timeout: 120
+    depends_on:
+      [draft-advance-responses, draft-hold-responses, draft-rejection-responses]
+    inputs:
+      drafts:
+        - outputs/comms/hiring/{date}/daily-advance-drafts.md
+        - outputs/comms/hiring/{date}/daily-hold-drafts.md
+        - outputs/comms/hiring/{date}/daily-rejection-drafts.md
+      approval_rules:
+        advance: pre-approved
+        hold: pre-approved
+        reject: pre-approved
+        offer_discussion: requires_ceo_approval
+    outputs:
+      file: outputs/briefs/daily/{date}/approval-queue-status.md
+
+  - id: produce-triage-summary
+    agent: hiring-org-design
+    action: produce-daily-triage-summary
+    description: Produce the daily applicant triage summary
+    timeout: 300
+    depends_on: [queue-for-approval]
+    inputs:
+      components:
+        - outputs/briefs/daily/{date}/new-applicants-consolidated.md
+        - outputs/briefs/daily/{date}/screening-scores.md
+        - outputs/briefs/daily/{date}/candidate-classification.md
+        - outputs/briefs/daily/{date}/approval-queue-status.md
+    outputs:
+      file: outputs/briefs/daily/{date}/applicant-triage.md
+
+  - id: notify-ready
+    action: notify
+    description: Signal that daily triage is complete
+    depends_on: [produce-triage-summary]
+    inputs:
+      channel: slack
+      target: "#ceo-office"
+      message: "Daily Applicant Triage complete: outputs/briefs/daily/{date}/applicant-triage.md — correspondence drafts queued for approval."
+      approval_required: false
+
+on_failure:
+  action: log-and-notify
+  message: "Daily applicant triage failed at step {failed_step}"
+  notify: agent-self # the executing agent (operator)
+  severity: medium
+
+final_output: outputs/briefs/daily/{date}/applicant-triage.md

package/workflows/daily/comms-triage.yaml

@@ -0,0 +1,80 @@
+# Communications Triage Workflow
+# Runs three times daily: 08:00, 12:00, 17:00
+
+name: comms-triage
+schedule: "0 8,12,17 * * *"
+timezone: Asia/Dubai
+description: >
+  Triages inbound communications across Slack, Email, and WhatsApp.
+  Identifies action items, flags urgencies, and routes to appropriate queues.
+
+steps:
+  - id: slack-scan
+    agent: slack-operator
+    action: channel-scan
+    description: Scan Slack for new messages, mentions, DMs since last triage
+    timeout: 300
+    inputs:
+      mode: observe
+      last_triage: "{last_run_timestamp}"
+      priority_channels: [] # from config/slack-channels.yaml
+      scan_type: incremental
+    outputs:
+      file: outputs/followups/daily/{date}/slack-triage-{time}.md
+
+  - id: email-scan
+    agent: gmail-operator
+    action: inbox-scan
+    description: Scan Gmail inbox for new messages since last triage
+    timeout: 300
+    parallel_with: slack-scan
+    inputs:
+      account: "{{agent.email}}" # resolved from config/agent.json at workflow execution
+      mode: observe
+      last_triage: "{last_run_timestamp}"
+    outputs:
+      file: outputs/followups/daily/{date}/email-triage-{time}.md
+
+  - id: whatsapp-scan
+    agent: whatsapp-operator
+    action: chat-scan
+    description: Scan WhatsApp for new messages since last triage
+    timeout: 180
+    parallel_with: slack-scan
+    inputs:
+      mode: observe
+      last_triage: "{last_run_timestamp}"
+    outputs:
+      file: outputs/followups/daily/{date}/whatsapp-triage-{time}.md
+
+  - id: extract-actions
+    agent: pmo-execution
+    action: extract-action-items
+    description: Extract action items from all triaged communications
+    timeout: 180
+    depends_on: [slack-scan, email-scan, whatsapp-scan]
+    inputs:
+      sources:
+        - outputs/followups/daily/{date}/slack-triage-{time}.md
+        - outputs/followups/daily/{date}/email-triage-{time}.md
+        - outputs/followups/daily/{date}/whatsapp-triage-{time}.md
+    outputs:
+      file: outputs/followups/daily/{date}/action-items-{time}.md
+      update: knowledge/memory/executive-memory.yaml # add to open_loops
+
+  - id: route-actions
+    agent: agent-self # the executing agent (operator)
+    action: route-action-items
+    description: Route extracted action items to appropriate queues and agents
+    timeout: 120
+    depends_on: [extract-actions]
+    inputs:
+      actions: outputs/followups/daily/{date}/action-items-{time}.md
+    outputs:
+      file: outputs/followups/daily/{date}/routing-log-{time}.md
+
+on_failure:
+  action: log-and-notify
+  message: "Communications triage failed at step {failed_step}"
+  notify: agent-self # the executing agent (operator)
+  severity: high

package/workflows/daily/evening-wrap.yaml

@@ -0,0 +1,105 @@
+# Evening CEO Wrap Workflow
+# Runs daily at 18:00 GST (UTC+4) on the Mac mini
+
+name: evening-wrap
+schedule: "0 18 * * *"
+timezone: Asia/Dubai
+description: >
+  Produces the CEO Evening Wrap — summarises what was completed today,
+  what remains open, tomorrow's priorities, and any escalations.
+
+steps:
+  - id: completed-today
+    agent: pmo-execution
+    action: daily-completion-report
+    description: Items closed or completed today
+    timeout: 120
+    inputs:
+      date: "{date}"
+      source: knowledge/memory/executive-memory.yaml
+    outputs:
+      file: outputs/briefs/daily/{date}/completed-today.md
+
+  - id: comms-review
+    agent: communications
+    action: daily-communications-summary
+    description: Summary of all communications sent and received today
+    timeout: 120
+    parallel_with: completed-today
+    inputs:
+      channels: [slack, email, whatsapp]
+      mode: observe
+    outputs:
+      file: outputs/briefs/daily/{date}/comms-review.md
+
+  - id: still-open
+    agent: pmo-execution
+    action: eod-open-items
+    description: Items that were expected to close today but didn't
+    timeout: 120
+    depends_on: [completed-today]
+    outputs:
+      file: outputs/briefs/daily/{date}/still-open.md
+
+  # ── Daily agent performance summary via agents-observe ──
+  - id: agent-performance-summary
+    skill: agents-observe
+    action: daily-performance-summary
+    description: >
+      Summarise today's agent execution — sessions run, items completed,
+      failures, and total token spend. Feeds into the evening wrap so
+      the CEO sees system operational health alongside business outcomes.
+    timeout: 120
+    parallel_with: still-open
+    inputs:
+      time_range: today
+      metrics:
+        - sessions_count
+        - items_resolved
+        - items_failed
+        - total_duration
+        - failure_details
+    outputs:
+      file: outputs/briefs/daily/{date}/agent-performance.md
+      summary:
+        sessions_today: 0
+        items_resolved: 0
+        items_failed: 0
+        total_agent_hours: ""
+
+  # ── EOD quota status via claude-pace ──
+  - id: eod-quota-status
+    skill: claude-pace
+    action: eod-quota-check
+    description: Report end-of-day quota position for overnight capacity planning
+    timeout: 30
+    parallel_with: still-open
+    outputs:
+      pace_delta: green|yellow|red
+      overnight_capacity_note: ""
+
+  - id: synthesise-wrap
+    agent: ceo-briefing
+    action: produce-evening-wrap
+    description: Produce the evening wrap document
+    timeout: 300
+    depends_on: [completed-today, comms-review, still-open, agent-performance-summary, eod-quota-status]
+    inputs:
+      morning_brief: outputs/briefs/daily/{date}/ceo-morning-brief.md
+      agent_performance: "{agent-performance-summary.outputs.summary}"
+      quota_status: "{eod-quota-status.outputs}"
+      components:
+        - outputs/briefs/daily/{date}/completed-today.md
+        - outputs/briefs/daily/{date}/comms-review.md
+        - outputs/briefs/daily/{date}/still-open.md
+        - outputs/briefs/daily/{date}/agent-performance.md
+    outputs:
+      file: outputs/briefs/daily/{date}/ceo-evening-wrap.md
+
+on_failure:
+  action: log-and-notify
+  message: "Evening wrap workflow failed at step {failed_step}"
+  notify: agent-self # the executing agent (operator)
+  severity: medium
+
+final_output: outputs/briefs/daily/{date}/ceo-evening-wrap.md