@crewx/sdk 0.9.0-rc.4 → 0.9.0-rc.41

package/dist/types/index.d.ts

@@ -397,6 +397,54 @@ export interface GuideRule {
     say: string;
     once?: boolean;
 }
+export declare const WiBoardSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    workflow_id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    goal_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    workflow_id: string;
+    description?: string | undefined;
+    goal_id?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    workflow_id: string;
+    description?: string | undefined;
+    goal_id?: string | undefined;
+}>;
+export type WiBoardConfig = z.infer<typeof WiBoardSchema>;
+export declare const SettingsSchema: z.ZodObject<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">>>>;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">>>>;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, z.ZodUnknown, "strip">>>>;
+}, z.ZodUnknown, "strip">>;
 export declare const CrewxProjectConfigSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -685,7 +733,34 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -977,7 +1052,34 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1269,7 +1371,34 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+        wi: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            boards: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>>;
+        }, z.ZodUnknown, "strip">>>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1299,6 +1428,7 @@ export interface CrewxOptions {
     };
     remoteFactory?: (configPath: string) => Promise<import('../facade/Crewx').Crewx>;
     includeBuiltIns?: boolean;
+    additionalArgsProvider?: import('../provider/bridge').AdditionalArgsProvider;
 }
 export interface QueryOptions {
     model?: string;
@@ -1306,6 +1436,9 @@ export interface QueryOptions {
     effort?: string;
     context?: string;
     metadata?: Record<string, unknown>;
+    overdrive?: boolean | {
+        mode?: 'count' | 'latch';
+    };
     threadId?: string;
     taskId?: string;
     platform?: Platform;
@@ -1314,6 +1447,7 @@ export interface QueryOptions {
     cwd?: string;
     resumeSessionId?: string;
     trace?: TraceContext;
+    callerIdentity?: CollaborationWorkspaceContext;
 }
 export interface QueryResult {
     ok: boolean;
@@ -1343,6 +1477,9 @@ export interface ExecuteOptions {
     effort?: string;
     context?: string;
     metadata?: Record<string, unknown>;
+    overdrive?: boolean | {
+        mode?: 'count' | 'latch';
+    };
     threadId?: string;
     taskId?: string;
     platform?: Platform;
@@ -1351,6 +1488,7 @@ export interface ExecuteOptions {
     cwd?: string;
     resumeSessionId?: string;
     trace?: TraceContext;
+    callerIdentity?: CollaborationWorkspaceContext;
 }
 export interface ExecuteResult {
     ok: boolean;

package/dist/utils/id.d.ts

@@ -1,4 +1,4 @@
-export type EntityPrefix = 'tsk' | 'thd' | 'msg' | 'box' | 'prj' | 'mem' | 'spn' | 'cron' | 'wbs' | 'job' | 'tcl' | 'req' | 'ws' | 'wfr';
+export type EntityPrefix = 'tsk' | 'thd' | 'msg' | 'box' | 'prj' | 'mem' | 'spn' | 'cron' | 'wbs' | 'job' | 'tcl' | 'req' | 'ws' | 'wfr' | 'ntf' | 'sug' | 'brd';
 export type PrefixedId<P extends EntityPrefix> = `${P}_${string}`;
 export declare function generateId<P extends EntityPrefix>(prefix: P): PrefixedId<P>;
 export declare function generateFingerprint<P extends EntityPrefix>(prefix: P, input: string): PrefixedId<P>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.9.0-rc.4",
+  "version": "0.9.0-rc.41",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -117,11 +117,12 @@
     "vitest": "3.2.4"
   },
   "scripts": {
+    "prebuild": "node scripts/generate-pricing.mjs && node scripts/generate-models.mjs",
     "build:cjs": "tsup --config tsup.cjs.js",
     "build:esm": "tsup --config tsup.esm.js",
     "build:browser": "tsup --config tsup.browser.js",
     "build:dts": "tsc -p tsconfig.dts.json",
-    "build": "pnpm run build:cjs && pnpm run build:esm && pnpm run build:browser && pnpm run build:dts && node scripts/copy-migrations.mjs",
+    "build": "pnpm run prebuild && pnpm run build:cjs && pnpm run build:esm && pnpm run build:browser && pnpm run build:dts && node scripts/copy-migrations.mjs",
     "db:generate": "cd ../.. && drizzle-kit generate --config drizzle.config.ts && node packages/sdk/scripts/post-generate.mjs",
     "db:check": "cd ../.. && drizzle-kit check --config drizzle.config.ts",
     "test": "vitest run --config ./vitest.config.ts",

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: auto
+      execute:
+        effort: high
+        mode: auto
     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: []