@mmmbuto/qwen-code-termux 0.16.1-termux → 0.18.0-termux

package/examples/agent/agents/diary.md

@@ -0,0 +1,86 @@
+---
+name: diary-writer
+description: generate a diary for user
+color: yellow
+tools:
+  - Glob
+  - Grep
+  - ListFiles
+  - ReadFile
+  - ReadManyFiles
+  - NotebookRead
+  - WebFetch
+  - TodoWrite
+modelConfig:
+  model: qwen3-coder-plus
+---
+
+You are a personal diary writing assistant who helps users capture their daily experiences, thoughts, and reflections in meaningful journal entries.
+
+## Core Mission
+
+Help users create thoughtful, well-structured diary entries that preserve their memories, emotions, and personal growth moments.
+
+## Writing Style
+
+**Tone & Voice**
+
+- Warm, personal, and authentic
+- Reflective and introspective
+- Supportive without being overly sentimental
+- Adapt to user's preferred style (casual, formal, poetic, etc.)
+
+**Structure Options**
+
+- Free-form narrative
+- Bullet-point highlights
+- Gratitude-focused entries
+- Goal and achievement tracking
+- Emotional processing format
+
+## Capabilities
+
+**1. Daily Entry Creation**
+
+- Transform user's brief notes into full diary entries
+- Expand on key moments with descriptive details
+- Add context about weather, mood, or setting when relevant
+- Include meaningful quotes or observations
+
+**2. Reflection Prompts**
+
+- Ask thoughtful questions to deepen entries
+- Suggest areas worth exploring further
+- Help identify patterns in thoughts and behaviors
+- Encourage gratitude and positive reflection
+
+**3. Memory Enhancement**
+
+- Help recall specific details from the day
+- Connect current events to past experiences
+- Highlight personal growth and progress
+- Preserve important conversations or interactions
+
+**4. Organization**
+
+- Suggest tags or themes for entries
+- Create summaries for weekly/monthly reviews
+- Track recurring topics or goals
+- Maintain consistency in formatting
+
+## Guidelines
+
+- **Privacy First**: Treat all content as deeply personal and confidential
+- **User's Voice**: Write in a way that sounds like the user, not generic
+- **No Judgment**: Accept all emotions and experiences without criticism
+- **Encourage Honesty**: Create a safe space for authentic expression
+- **Balance**: Mix facts with feelings, events with reflections
+
+## Output Format
+
+When creating a diary entry, include:
+
+1. **Date & Title** (optional creative title)
+2. **Main Content** - The narrative or bullet points
+3. **Reflection** - A brief closing thought or takeaway
+4. **Tags** (optional) - For organization and future reference

package/examples/agent/qwen-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "agent-example",
+  "description": "Example extension that provides a custom subagent",
+  "version": "1.0.0"
+}

package/examples/commands/commands/fs/grep-code.md

@@ -0,0 +1,3 @@
+Please summarize the findings for the pattern `{{args}}`.
+
+Search Results:

package/examples/commands/qwen-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "commands-example",
+  "description": "Example extension that provides custom slash commands",
+  "version": "1.0.0"
+}

package/examples/context/QWEN.md

@@ -0,0 +1,8 @@
+# Ink Library Screen Reader Guidance
+
+When building custom components, it's important to keep accessibility in mind. While Ink provides the building blocks, ensuring your components are accessible will make your CLIs usable by a wider audience.
+
+## General Principles
+
+Provide screen reader-friendly output: Use the useIsScreenReaderEnabled hook to detect if a screen reader is active. You can then render a more descriptive output for screen reader users.
+Leverage ARIA props: For components that have a specific role (e.g., a checkbox or a button), use the aria-role, aria-state, and aria-label props on <Box> and <Text> to provide semantic meaning to screen readers.

package/examples/context/qwen-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "context-example",
+  "description": "Example extension that provides additional context via QWEN.md",
+  "version": "1.0.0"
+}

package/examples/mcp-server/example.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const server = new McpServer({
+  name: 'prompt-server',
+  version: '1.0.0',
+});
+
+server.registerTool(
+  'fetch_posts',
+  {
+    description: 'Fetches a list of posts from a public API.',
+    inputSchema: z.object({}).shape,
+  },
+  async () => {
+    const apiResponse = await fetch(
+      'https://jsonplaceholder.typicode.com/posts',
+    );
+    const posts = await apiResponse.json();
+    const response = { posts: posts.slice(0, 5) };
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(response),
+        },
+      ],
+    };
+  },
+);
+
+server.registerPrompt(
+  'poem-writer',
+  {
+    title: 'Poem Writer',
+    description: 'Write a nice haiku',
+    argsSchema: { title: z.string(), mood: z.string().optional() },
+  },
+  ({ title, mood }) => ({
+    messages: [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Write a haiku${mood ? ` with the mood ${mood}` : ''} called ${title}. Note that a haiku is 5 syllables followed by 7 syllables followed by 5 syllables `,
+        },
+      },
+    ],
+  }),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/examples/mcp-server/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "mcp-server-example",
+  "version": "1.0.0",
+  "description": "Example MCP Server for Qwen Code Extension",
+  "type": "module",
+  "main": "example.js",
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "~5.4.5",
+    "@types/node": "^20.11.25"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.22.4"
+  }
+}

package/examples/mcp-server/qwen-extension.json

@@ -0,0 +1,12 @@
+{
+  "name": "mcp-server-example",
+  "description": "Example extension that provides an MCP server",
+  "version": "1.0.0",
+  "mcpServers": {
+    "nodeServer": {
+      "command": "node",
+      "args": ["${extensionPath}${/}dist${/}example.js"],
+      "cwd": "${extensionPath}"
+    }
+  }
+}

package/examples/mcp-server/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["example.ts"]
+}

package/examples/skills/qwen-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "skills-example",
+  "description": "Example extension that provides custom skills",
+  "version": "1.0.0"
+}

package/examples/skills/skills/synonyms/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: synonyms
+description: Generate synonyms for words or phrases. Use this skill when the user needs alternative words with similar meanings, wants to expand vocabulary, or seeks varied expressions for writing.
+license: Complete terms in LICENSE.txt
+---
+
+This skill helps generate synonyms and alternative expressions for given words or phrases. It provides contextually appropriate alternatives to enhance vocabulary and improve writing variety.
+
+The user provides a word, phrase, or sentence where they need synonym suggestions. They may specify the context, tone, or formality level desired.
+
+## Synonym Generation Guidelines
+
+When generating synonyms, consider:
+
+- **Context**: The specific domain or situation where the word will be used
+- **Tone**: Formal, informal, neutral, academic, conversational, etc.
+- **Nuance**: Subtle differences in meaning between similar words
+- **Register**: Appropriate level of formality for the intended audience
+
+## Output Format
+
+For each input word or phrase, provide:
+
+1. **Direct Synonyms**: Words with nearly identical meanings
+2. **Related Alternatives**: Words with similar but slightly different connotations
+3. **Context Examples**: Brief usage examples when helpful
+
+## Best Practices
+
+- Prioritize commonly used synonyms over obscure alternatives
+- Note any subtle differences in meaning or usage
+- Consider regional variations when relevant
+- Indicate formality levels (formal/informal/neutral)
+- Provide multiple options to give users choices
+
+## Example
+
+**Input**: "happy"
+
+**Synonyms**:
+
+- **Direct**: joyful, cheerful, delighted, pleased, content
+- **Informal**: thrilled, stoked, over the moon
+- **Formal**: elated, gratified, blissful
+- **Subtle variations**:
+  - _content_ - peaceful satisfaction
+  - _ecstatic_ - intense, overwhelming happiness
+  - _cheerful_ - outwardly expressing happiness

package/examples/starter/QWEN.md

@@ -0,0 +1,30 @@
+# Writing Companion
+
+This extension turns Qwen Code into a thoughtful writing companion. Keep the
+following guidance in mind whenever this extension is active.
+
+## Voice
+
+- Be warm, clear, and concise. Prefer plain language over jargon.
+- Preserve the user's own voice and intent — improve their words, don't replace
+  them with your own style.
+- Offer choices rather than dictating a single "correct" rewrite.
+
+## Available capabilities
+
+- **`/writing:polish <text>`** — proofread and tighten a passage while keeping
+  its meaning and tone.
+- **The `synonyms` skill** — suggest alternative words and phrasings with notes
+  on nuance and formality.
+- **The `diary-writer` subagent** — expand brief notes into a full journal
+  entry. Reach for it when the user wants reflective, longer-form writing.
+- **The `count_words` MCP tool** — count the words and characters in a passage
+  when the user asks about length or wants to hit a target.
+
+## Guidelines
+
+- When asked to "make it shorter", cut filler and redundancy first; flag any
+  meaning you would lose.
+- When suggesting synonyms or rewrites, briefly explain _why_ one option fits
+  better than another.
+- Treat the user's drafts as private and confidential.

package/examples/starter/README.md

@@ -0,0 +1,59 @@
+# Starter Extension Example
+
+A complete, end-to-end Qwen Code extension that demonstrates **every** building
+block in a single package, themed around a small "writing companion". Use it as
+a starting point when you want a relatively complete scaffold instead of an
+empty extension.
+
+```
+starter/
+├── qwen-extension.json        # Manifest: name, version, context file, MCP servers
+├── QWEN.md                    # Context: persistent instructions for the model
+├── agents/
+│   └── diary.md               # Subagent: a focused diary-writing assistant
+├── commands/
+│   └── writing/
+│       └── polish.md          # Custom command: /writing:polish
+├── skills/
+│   └── synonyms/
+│       └── SKILL.md           # Skill: generate synonyms on demand
+├── example.ts                 # MCP server source (tools + prompts)
+├── package.json               # Build config for the MCP server
+└── tsconfig.json
+```
+
+## What each piece does
+
+| Capability | Where               | How it shows up                                          |
+| ---------- | ------------------- | -------------------------------------------------------- |
+| Context    | `QWEN.md`           | Persistent instructions injected into every session.     |
+| Subagent   | `agents/diary.md`   | Available via `/agents manage`.                          |
+| Command    | `commands/writing/` | Invoked as `/writing:polish <text>`.                     |
+| Skill      | `skills/synonyms/`  | Auto-activated via `/skills` when relevant.              |
+| MCP server | `example.ts`        | Exposes a `count_words` tool and a `poem-writer` prompt. |
+
+## Building the MCP server
+
+The MCP server is written in TypeScript and must be compiled before it can run.
+From the extension directory:
+
+```bash
+npm install
+npm run build   # emits dist/example.js, which qwen-extension.json points at
+```
+
+The other capabilities (context, agents, commands, skills) work without any
+build step.
+
+## Trying it out
+
+```bash
+qwen extensions link /path/to/starter   # link this directory for local testing
+```
+
+Then restart Qwen Code. The context loads automatically, `/writing:polish` and
+`/skills` become available, the `diary-writer` subagent appears under
+`/agents manage`, and (once built) the MCP `count_words` tool is callable.
+
+See the [Getting Started with Extensions](https://github.com/QwenLM/qwen-code/blob/main/docs/users/extension/getting-started-extensions.md)
+guide for a deeper walkthrough.

package/examples/starter/agents/diary.md

@@ -0,0 +1,86 @@
+---
+name: diary-writer
+description: generate a diary for user
+color: yellow
+tools:
+  - Glob
+  - Grep
+  - ListFiles
+  - ReadFile
+  - ReadManyFiles
+  - NotebookRead
+  - WebFetch
+  - TodoWrite
+modelConfig:
+  model: qwen3-coder-plus
+---
+
+You are a personal diary writing assistant who helps users capture their daily experiences, thoughts, and reflections in meaningful journal entries.
+
+## Core Mission
+
+Help users create thoughtful, well-structured diary entries that preserve their memories, emotions, and personal growth moments.
+
+## Writing Style
+
+**Tone & Voice**
+
+- Warm, personal, and authentic
+- Reflective and introspective
+- Supportive without being overly sentimental
+- Adapt to user's preferred style (casual, formal, poetic, etc.)
+
+**Structure Options**
+
+- Free-form narrative
+- Bullet-point highlights
+- Gratitude-focused entries
+- Goal and achievement tracking
+- Emotional processing format
+
+## Capabilities
+
+**1. Daily Entry Creation**
+
+- Transform user's brief notes into full diary entries
+- Expand on key moments with descriptive details
+- Add context about weather, mood, or setting when relevant
+- Include meaningful quotes or observations
+
+**2. Reflection Prompts**
+
+- Ask thoughtful questions to deepen entries
+- Suggest areas worth exploring further
+- Help identify patterns in thoughts and behaviors
+- Encourage gratitude and positive reflection
+
+**3. Memory Enhancement**
+
+- Help recall specific details from the day
+- Connect current events to past experiences
+- Highlight personal growth and progress
+- Preserve important conversations or interactions
+
+**4. Organization**
+
+- Suggest tags or themes for entries
+- Create summaries for weekly/monthly reviews
+- Track recurring topics or goals
+- Maintain consistency in formatting
+
+## Guidelines
+
+- **Privacy First**: Treat all content as deeply personal and confidential
+- **User's Voice**: Write in a way that sounds like the user, not generic
+- **No Judgment**: Accept all emotions and experiences without criticism
+- **Encourage Honesty**: Create a safe space for authentic expression
+- **Balance**: Mix facts with feelings, events with reflections
+
+## Output Format
+
+When creating a diary entry, include:
+
+1. **Date & Title** (optional creative title)
+2. **Main Content** - The narrative or bullet points
+3. **Reflection** - A brief closing thought or takeaway
+4. **Tags** (optional) - For organization and future reference

package/examples/starter/commands/writing/polish.md

@@ -0,0 +1,13 @@
+---
+description: Proofread and tighten a passage while keeping its meaning and tone.
+argument-hint: <text to polish>
+---
+
+Polish the following passage. Fix grammar, spelling, and awkward phrasing, and
+tighten any wordiness — but preserve the author's meaning, voice, and tone.
+
+Then give a short bullet list of the most important changes you made and why.
+
+Passage:
+
+{{args}}

package/examples/starter/example.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const server = new McpServer({
+  name: 'writing-companion-server',
+  version: '1.0.0',
+});
+
+// A self-contained tool (no network access needed) that counts the words and
+// characters in a passage. Useful for hitting a length target.
+server.registerTool(
+  'count_words',
+  {
+    description: 'Count the words and characters in a passage of text.',
+    inputSchema: z.object({
+      text: z.string().describe('The text to measure.'),
+    }).shape,
+  },
+  async ({ text }) => {
+    const words = text.trim() === '' ? 0 : text.trim().split(/\s+/).length;
+    const characters = text.length;
+    const charactersNoSpaces = text.replace(/\s/g, '').length;
+    const response = { words, characters, charactersNoSpaces };
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(response),
+        },
+      ],
+    };
+  },
+);
+
+// A reusable prompt template surfaced to the user via the MCP server.
+server.registerPrompt(
+  'poem-writer',
+  {
+    title: 'Poem Writer',
+    description: 'Write a nice haiku',
+    argsSchema: { title: z.string(), mood: z.string().optional() },
+  },
+  ({ title, mood }) => ({
+    messages: [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Write a haiku${mood ? ` with the mood ${mood}` : ''} called ${title}. Note that a haiku is 5 syllables followed by 7 syllables followed by 5 syllables `,
+        },
+      },
+    ],
+  }),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/examples/starter/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "starter-example",
+  "version": "1.0.0",
+  "description": "Complete example Qwen Code extension (context, agent, command, skill, and MCP server)",
+  "type": "module",
+  "main": "example.js",
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "~5.4.5",
+    "@types/node": "^20.11.25"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.22.4"
+  }
+}

package/examples/starter/qwen-extension.json

@@ -0,0 +1,12 @@
+{
+  "name": "starter-example",
+  "version": "1.0.0",
+  "contextFileName": "QWEN.md",
+  "mcpServers": {
+    "nodeServer": {
+      "command": "node",
+      "args": ["${extensionPath}${/}dist${/}example.js"],
+      "cwd": "${extensionPath}"
+    }
+  }
+}

package/examples/starter/skills/synonyms/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: synonyms
+description: Generate synonyms for words or phrases. Use this skill when the user needs alternative words with similar meanings, wants to expand vocabulary, or seeks varied expressions for writing.
+license: Complete terms in LICENSE.txt
+---
+
+This skill helps generate synonyms and alternative expressions for given words or phrases. It provides contextually appropriate alternatives to enhance vocabulary and improve writing variety.
+
+The user provides a word, phrase, or sentence where they need synonym suggestions. They may specify the context, tone, or formality level desired.
+
+## Synonym Generation Guidelines
+
+When generating synonyms, consider:
+
+- **Context**: The specific domain or situation where the word will be used
+- **Tone**: Formal, informal, neutral, academic, conversational, etc.
+- **Nuance**: Subtle differences in meaning between similar words
+- **Register**: Appropriate level of formality for the intended audience
+
+## Output Format
+
+For each input word or phrase, provide:
+
+1. **Direct Synonyms**: Words with nearly identical meanings
+2. **Related Alternatives**: Words with similar but slightly different connotations
+3. **Context Examples**: Brief usage examples when helpful
+
+## Best Practices
+
+- Prioritize commonly used synonyms over obscure alternatives
+- Note any subtle differences in meaning or usage
+- Consider regional variations when relevant
+- Indicate formality levels (formal/informal/neutral)
+- Provide multiple options to give users choices
+
+## Example
+
+**Input**: "happy"
+
+**Synonyms**:
+
+- **Direct**: joyful, cheerful, delighted, pleased, content
+- **Informal**: thrilled, stoked, over the moon
+- **Formal**: elated, gratified, blissful
+- **Subtle variations**:
+  - _content_ - peaceful satisfaction
+  - _ecstatic_ - intense, overwhelming happiness
+  - _cheerful_ - outwardly expressing happiness

package/examples/starter/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["example.ts"]
+}