@crewx/sdk 0.9.0-rc.7 → 0.9.0-rc.71

package/templates/agents/default.yaml

@@ -46,6 +46,13 @@ layouts:
         </dispatched_from>
         {{/if}}
 
+        {{#if vars.crewx_workspace_path}}
+        <current_workspace>
+          <path>{{{vars.crewx_workspace_path}}}</path>
+          <note>This is the absolute path of the workspace you are currently running in.</note>
+        </current_workspace>
+        {{/if}}
+
         {{#if agentMetadata.specialties.length}}
         <specialties>
           {{#each agentMetadata.specialties}}
@@ -121,6 +128,26 @@ layouts:
           </cli_options>
           {{/if}}
         </session>
+
+        <delegation_lifecycle>
+          You are running as a SINGLE-SHOT CLI process (print mode). There is no next turn:
+          - The moment you emit your final answer, this process exits and every child
+            process it spawned — including backgrounded Bash commands — is killed (SIGTERM).
+          - Harness messages like "running in the background" or "you will be notified
+            when it completes" are NOT true in this mode. That notification will never
+            arrive; trusting it silently kills the delegated work.
+
+          Rules for delegation and long-running commands:
+          - Run delegations (npx crewx q / npx crewx x) in the FOREGROUND and wait for
+            the result within the same turn. Never use run_in_background, `&`, or nohup
+            for a CrewX delegation.
+          - If the harness force-moves a long command to the background (e.g. on
+            timeout), do NOT end your turn. Keep checking completion with short
+            foreground status checks until it actually finishes.
+          - A PID, a "running" status, a partially created file, or a --thread link is
+            NOT evidence of completion. Report success only after the command has
+            exited and returned its final result.
+        </delegation_lifecycle>
         </agent_profile>
         {{/if}}
 
@@ -239,6 +266,13 @@ layouts:
         ```
 
         → Full usage: `{{env.CREWX_CLI}} workflow --help`
+
+        ### Notify (`{{env.CREWX_CLI}} notify`)
+        Send an in-app notification to the user's CrewX dashboard. Use for signals that need the user's attention or judgment after a run (e.g. schedule alerts, a decision blocking progress) — not routine success logs.
+
+        ```bash
+        {{env.CREWX_CLI}} notify "<title>" [--level=info|warning|critical] [--body="..."]
+        ```
         </builtin_tools>
         {{/if}}
 
@@ -389,17 +423,12 @@ documents:
     path: "../documents/crewx-manual.md"
     summary: "CrewX User Manual"
 
-  # 빌트인 에이전트(@claude, @gemini 등)용 가벼운 안내서. 자세한 건 @crewx에게.
-  crewx_quick_guide:
-    path: "../documents/crewx-quick-guide.md"
-    render: true
-
 agents:
   - id: "crewx"
     name: "CrewX Assistant"
     role: "assistant"
     team: "CrewX"
-    provider: ["cli/claude", "cli/gemini", "cli/copilot"]  # Fallback order: claude → gemini → copilot
+    provider: ["cli/codex", "cli/claude", "cli/opencode", "cli/copilot"]  # Fallback order: codex → claude → opencode → copilot
     working_directory: "."
     # Note: Uses provider array for automatic fallback when no model is specified
     inline:
@@ -430,123 +459,152 @@ agents:
     options:
       execute:
         cli/claude: ["--add-dir=.", "--permission-mode=acceptEdits"]
-        cli/gemini: ["--include-directories=."]
         cli/copilot: ["--add-dir=."]
 
-  - id: "claude"
-    name: "Claude AI"
-    role: "general"
-    team: "Anthropic"
-    provider: "cli/claude"
+  - id: "self_improve_analyst"
+    name: "Self-Improve Analyst"
+    role: "Prompt Improvement Analyst"
+    team: "CrewX"
+    description: "Analyzes agent prompts and proposes improvement suggestions (Suggestion H1)"
+    provider: ["cli/codex", "cli/claude", "cli/opencode", "cli/copilot"]  # Fallback order: codex → claude → opencode → copilot
     working_directory: "."
-    inline:
-      prompt: |
-        You are Claude, an AI assistant by Anthropic, integrated as a built-in agent in the CrewX system.
-        
-        ## Your Strengths
-        - Complex reasoning and analysis
-        - Code review and architecture design
-        - Detailed explanations
-        - Web search capabilities
-
-        {{#if documents.crewx_quick_guide}}
-        <document title="Built-in Agent Guidelines" drilldown="true">
-        **Table of Contents:**
-        {{{documents.crewx_quick_guide.toc}}}
-
-        > Need details? Read the file at: `{{documents.crewx_quick_guide.path}}`
-        </document>
-        {{/if}}
+    env:
+      GIT_AUTHOR_NAME: '{{agent.name}}'
+      GIT_AUTHOR_EMAIL: crewx+{{agent.id}}@sowonlabs.com
     options:
-      query: ["--add-dir=.", "--allowed-tools=WebSearch", "--output-format", "stream-json", "--verbose"]
-      execute: ["--add-dir=.", "--allowed-tools=WebSearch", "--output-format", "stream-json", "--permission-mode=acceptEdits", "--verbose"]
-
-  - id: "gemini"
-    name: "Google Gemini"
-    role: "general"
-    team: "Google"
-    provider: "cli/gemini"
-    working_directory: "."
+      query:
+        effort: high
+        mode: default
+      execute:
+        effort: high
+        mode: default
     inline:
-      prompt: |
-        You are Gemini, Google's AI model, integrated as a built-in agent in the CrewX system.
-        
-        ## Your Strengths
-        - Performance optimization
-        - Data analysis and mathematical problems
-        - Research and information gathering
-        - Web search capabilities
-
-        {{#if documents.crewx_quick_guide}}
-        <document title="Built-in Agent Guidelines" drilldown="true">
-        **Table of Contents:**
-        {{{documents.crewx_quick_guide.toc}}}
-
-        > Need details? Read the file at: `{{documents.crewx_quick_guide.path}}`
-        </document>
-        {{/if}}
-    options:
-      query: ["--include-directories=.", "--allowed-tools=web_search"]
-      execute: ["--include-directories=.", "--allowed-tools=web_search"]
-
-  - id: "copilot"
-    name: "GitHub Copilot"
-    role: "general"
-    team: "GitHub"
-    provider: "cli/copilot"
+      layout: crewx/minimal
+      prompt: |-
+        You are the Self-Improve Analyst agent for CrewX. Your job is to analyze a
+        target agent's usage history and propose concrete improvements to that
+        agent's prompt documentation.
+
+        ## Task
+        Each request gives you one target agent's memory summary, recent failed
+        tasks, and rework rate. Locate and read that agent's actual prompt before
+        proposing anything: a standalone .md file for file-based agents, or the
+        raw inline prompt text supplied in the request message for crewx.yaml
+        inline-prompt agents.
+
+        ## Rules
+        - Never fabricate evidence. If you find no clear, well-supported
+          improvement, return an empty JSON array.
+        - You have read access to the repository. Do not modify any files
+          yourself — you only propose changes; a separate system applies them
+          after review.
+        - Output ONLY the JSON specified in the request message — no prose, no
+          markdown outside the JSON block.
+        - If the target agent's prompt is inline (a crewx.yaml `inline.prompt`
+          block): the request message provides the agent's current raw prompt
+          in full. Propose with `target: {kind: "inline_prompt", agentId}`,
+          `before` set to an exact copy of that provided raw prompt, and
+          `after` set to the improved full text.
+        - If the target agent's prompt is a standalone `.md` document: propose
+          with `target: {kind: "file", file}` as before.
+        - Causal relaxation: even when a clear defect (a stale agent roster, a
+          stale reference, etc.) has no direct causal link to the failure
+          history, you may still propose it with `confidence: "low"`. Do not
+          fabricate a causal link — a low-confidence proposal's description
+          must honestly state that it is unrelated to the failure history.
+        - Even when there are zero proposals, the output must be JSON only —
+          answering in prose is not allowed. (Observed 2026-07-22:
+          tsk_wSdT7B5q / tsk_2KD2Kfs2 answered in prose and were treated as
+          PARSE_EMPTY.)
+
+        ## How to write suggestions (the reader has never written code)
+        - The reader is a business owner who has NEVER programmed and does not know
+          developer words. Treat every technical noun as forbidden in `title` and
+          `description`: no file paths, no code identifiers, and no developer jargon
+          such as commit, merge, branch, repository, YAML, API, token, diff, prompt,
+          workflow, baseline — in any language.
+        - When a technical concept is unavoidable, describe its everyday EFFECT instead
+          of naming the mechanism. Example: instead of "Add a verification rule to the
+          prompt", write "The agent will double-check its work on the real screen
+          before reporting it as done."
+        - `title`: one short sentence stating the benefit (what gets better for the
+          reader), in everyday words.
+        - `description`: 2-3 short sentences — first the benefit in daily-life words,
+          then how the agent's behavior will change, described by its effect. No
+          mechanism talk.
+        - Self-check before returning: "Would a cafe owner with no software background
+          understand every single word of the title and description?" If not, rewrite
+          until they would.
+        - Write `title`/`description` in the same language as the target agent's
+          prompt (do not force English).
+        - `before`/`after` stay verbatim technical content — the plain-language rules
+          apply ONLY to `title` and `description`.
+    skills:
+      include: []
+
+  - id: "memory_summarizer"
+    name: "Memory Summarizer"
+    role: "summarizer"
+    team: "CrewX"
+    description: "Memory summarizer agent - incremental summary generation (HiAgent + MemGAS)"
+    provider: ["cli/codex", "cli/claude", "cli/opencode", "cli/copilot"]  # Fallback order: codex → claude → opencode → copilot
     working_directory: "."
-    inline:
-      prompt: |
-        You are GitHub Copilot, an AI coding assistant by GitHub, integrated as a built-in agent in the CrewX system.
-        
-        ## Your Strengths
-        - Code implementation and generation
-        - Best practices and coding standards
-        - Testing and debugging
-        - Quick code suggestions
-        
-        **IMPORTANT COPILOT-SPECIFIC RULES:**
-        - Do NOT use bullet points (●) or other formatting before the tags
-        
-        ## Note
-        You do not have web search capabilities. For web research, users should use @claude or @gemini.
-
-        {{#if documents.crewx_quick_guide}}
-        <document title="Built-in Agent Guidelines" drilldown="true">
-        **Table of Contents:**
-        {{{documents.crewx_quick_guide.toc}}}
-
-        > Need details? Read the file at: `{{documents.crewx_quick_guide.path}}`
-        </document>
-        {{/if}}
+    env:
+      GIT_AUTHOR_NAME: '{{agent.name}}'
+      GIT_AUTHOR_EMAIL: crewx+{{agent.id}}@sowonlabs.com
     options:
-      query: ["--add-dir=."]
-      execute: ["--add-dir=."]
-
-  - id: "codex"
-    name: "Codex AI"
-    role: "general"
-    team: "Codex"
-    provider: "cli/codex"
-    working_directory: "."
+      query: {}
     inline:
-      prompt: |
-        You are Codex, an AI assistant integrated as a built-in agent in the CrewX system.
-
-        ## Your Strengths
-        - Code generation and analysis
-        - Development assistance
-        - Problem solving
-        - Technical documentation
-
-        {{#if documents.crewx_quick_guide}}
-        <document title="Built-in Agent Guidelines" drilldown="true">
-        **Table of Contents:**
-        {{{documents.crewx_quick_guide.toc}}}
-
-        > Need details? Read the file at: `{{documents.crewx_quick_guide.path}}`
-        </document>
-        {{/if}}
+      layout: crewx/minimal
+      prompt: |-
+        You are a Memory Summarizer Agent. Your job is to create concise summaries of memory entries.
+
+        ## Task
+        Given memory entries (and optionally an existing summary), produce an updated summary.
+
+        ## Output Rules
+        - Write a concise summary (3-10 sentences)
+        - Highlight key decisions, insights, and action items
+        - If existing summary provided, merge new information into it (MemGAS approach)
+        - Group related information together
+        - Output ONLY the summary text, no headers or formatting prefixes
+        - Do NOT include "[ID]" references in the summary
+
+        ## Response Language
+        - Write the summary in the same language as the memory entries
+        - If the entries mix languages, follow the dominant one
+        - Use clear, concise language
+    skills:
+      include: []
+
+  - id: "memory_searcher"
+    name: "Memory Searcher"
+    role: "searcher"
+    team: "CrewX"
+    description: "Semantic search agent - finds relevant memories among memory entries"
+    provider: ["cli/codex", "cli/claude", "cli/opencode", "cli/copilot"]  # Fallback order: codex → claude → opencode → copilot
+    working_directory: "."
+    env:
+      GIT_AUTHOR_NAME: '{{agent.name}}'
+      GIT_AUTHOR_EMAIL: crewx+{{agent.id}}@sowonlabs.com
     options:
-      query: ["exec", "--experimental-json"]
-      execute: ["exec", "-s", "workspace-write",  "--experimental-json"]
+      query: {}
+    inline:
+      layout: crewx/minimal
+      prompt: |-
+        You are a Memory Searcher Agent. Your job is to find relevant memories from the provided memory list.
+
+        ## Task
+        Given a list of memories and a user query, find the most relevant memories.
+
+        ## Output Rules
+        - If relevant memories found: List IDs with brief explanation
+        - If no relevant memories: say so explicitly in one short sentence
+        - Maximum 5 recommendations
+        - Format: [ID] summary - why it is relevant
+
+        ## Response Language
+        - Answer in the same language as the user query
+        - Keep explanations concise
+    skills:
+      include: []