@mcphero/examples 1.1.6

package/.turbo/turbo-build.log

@@ -0,0 +1,7 @@
+
+
+> @mcphero/examples@1.1.6 build /Users/atomic/projects/ai/mcphero/example
+> tsup
+
+No input files, try "tsup <your-file>" instead
+ ELIFECYCLE  Command failed with exit code 1.

package/.turbo/turbo-check.log

@@ -0,0 +1,10 @@
+
+> @mcphero/examples@1.1.6 check /Users/atomic/projects/ai/mcphero/example
+> pnpm lint && pnpm typecheck
+
+
+> @mcphero/examples@1.1.6 lint /Users/atomic/projects/ai/mcphero/example
+> eslint
+
+ ELIFECYCLE  Command failed.
+ ELIFECYCLE  Command failed.

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @mcphero/examples@1.1.6 lint /Users/atomic/projects/ai/mcphero/example
+> eslint
+

package/eslint.config.mjs

@@ -0,0 +1,99 @@
+import eslint from '@eslint/js'
+import stylistic from '@stylistic/eslint-plugin'
+import { defineConfig } from 'eslint/config'
+import tseslint from 'typescript-eslint'
+
+export default defineConfig(eslint.configs.recommended, tseslint.configs.recommendedTypeChecked, tseslint.configs.stylisticTypeChecked, {
+  languageOptions: {
+    parserOptions: {
+      project: 'tsconfig.json',
+      tsconfigRootDir: import.meta.dirname
+    }
+  },
+  plugins: { '@stylistic': stylistic },
+  rules: {
+    '@stylistic/space-in-parens': ['error'],
+    '@stylistic/comma-spacing': ['error'],
+    '@stylistic/no-multi-spaces': ['error'],
+    '@stylistic/no-trailing-spaces': ['error'],
+    '@stylistic/no-whitespace-before-property': ['error'],
+    '@stylistic/array-bracket-newline': ['error', 'consistent'],
+    '@stylistic/array-bracket-spacing': ['error'],
+    '@stylistic/arrow-spacing': ['error'],
+    '@stylistic/arrow-parens': ['error', 'always'],
+    '@stylistic/block-spacing': ['error', 'always'],
+    '@stylistic/brace-style': ['error', '1tbs', { 'allowSingleLine': true }],
+    '@stylistic/comma-dangle': ['error', 'never'],
+    '@stylistic/key-spacing': ['error'],
+    '@stylistic/keyword-spacing': ['error'],
+    '@stylistic/member-delimiter-style': ['error', { 'multiline': { 'delimiter': 'none' } }],
+    '@stylistic/no-extra-semi': ['error'],
+    '@stylistic/indent': ['error', 2],
+    '@stylistic/no-multiple-empty-lines': ['error', { 'max': 1, 'maxEOF': 0, 'maxBOF': 0 }],
+    '@stylistic/object-curly-spacing': ['error', 'always'],
+    '@stylistic/quotes': ['error', 'single'],
+    '@stylistic/semi': ['error', 'never'],
+    '@stylistic/space-before-blocks': ['error', 'always'],
+    '@stylistic/space-before-function-paren': ['error', { 'anonymous': 'always', 'named': 'never', 'asyncArrow': 'always' }],
+    '@typescript-eslint/adjacent-overload-signatures': 'error',
+    '@typescript-eslint/array-type': 'off',
+    '@typescript-eslint/await-thenable': 'error',
+    '@typescript-eslint/ban-types': 'off',
+    '@typescript-eslint/consistent-type-assertions': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-member-accessibility': 'off',
+    '@typescript-eslint/no-angle-bracket-type-assertion': 'off',
+    '@typescript-eslint/no-empty-function': 'off',
+    '@typescript-eslint/no-empty-interface': 'off',
+    '@typescript-eslint/no-extra-non-null-assertion': 'error',
+    '@typescript-eslint/no-floating-promises': 'off',
+    '@typescript-eslint/no-misused-new': 'error',
+    '@typescript-eslint/no-misused-promises': 'off',
+    '@typescript-eslint/no-namespace': 'off',
+    '@typescript-eslint/no-non-null-asserted-optional-chain': 'error',
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    '@typescript-eslint/no-object-literal-type-assertion': 'off',
+    '@typescript-eslint/no-parameter-properties': 'off',
+    '@typescript-eslint/no-shadow': 'error',
+    '@typescript-eslint/no-triple-slash-reference': 'off',
+    '@typescript-eslint/no-unused-vars': ['error', {
+      'args': 'all',
+      'argsIgnorePattern': '^_',
+      'caughtErrors': 'all',
+      'caughtErrorsIgnorePattern': '^_',
+      'destructuredArrayIgnorePattern': '^_',
+      'varsIgnorePattern': '^_',
+      'ignoreRestSiblings': true
+    }],
+    '@typescript-eslint/no-use-before-define': 'off',
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/prefer-for-of': 'error',
+    '@typescript-eslint/prefer-interface': 'off',
+    '@typescript-eslint/prefer-nullish-coalescing': 'off',
+    '@typescript-eslint/prefer-optional-chain': 'error',
+    '@typescript-eslint/return-await': 'error',
+    '@typescript-eslint/unified-signatures': 'error',
+    '@typescript-eslint/no-unsafe-return': 'off',
+    '@typescript-eslint/no-redundant-type-constituents': 'off',
+    '@typescript-eslint/no-unsafe-member-access': 'off',
+    '@typescript-eslint/no-unsafe-call': 'off',
+    '@typescript-eslint/no-unsafe-argument': 'off',
+    '@typescript-eslint/no-unsafe-assignment': 'off',
+    '@typescript-eslint/dot-notation': 'off',
+    '@typescript-eslint/prefer-regexp-exec': 'off',
+    '@typescript-eslint/require-await': 'off',
+    '@typescript-eslint/only-throw-error': ['error', {
+      'allow': [
+        { from: 'package', name: 'TypedResponse', package: '@remix-run/server-runtime' },
+        { from: 'lib', name: 'Response' }
+      ]
+    }],
+    '@typescript-eslint/no-base-to-string': 'off',
+    '@typescript-eslint/restrict-template-expressions': 'off'
+  }
+}, {
+  files: ['eslint.config.mjs'],
+  extends: [tseslint.configs.disableTypeChecked]
+}, {
+  ignores: ['build', 'tsup.config.ts']
+})

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@mcphero/examples",
+  "version": "1.1.6",
+  "description": "MCP Hero Examples",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/atomicbi/mcphero.git",
+    "directory": "example"
+  },
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "dependencies": {
+    "@mcphero/cli": "1.1.6",
+    "@mcphero/core": "1.1.6",
+    "@mcphero/logger": "1.1.6",
+    "@mcphero/fastify": "1.1.6",
+    "@mcphero/mcp": "1.1.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "check": "pnpm lint && pnpm typecheck"
+  }
+}

package/resources/83ede315-6ebc-4b38-b84b-d046a85102db

@@ -0,0 +1 @@
+the secret code is "pirates"

package/resources/83ede315-6ebc-4b38-b84b-d046a85102db.json

@@ -0,0 +1 @@
+{"id":"83ede315-6ebc-4b38-b84b-d046a85102db","name":"SECRET.md","contentType":"text/plain","size":28}

package/resources/9372c0a4-bb5a-4164-a67f-0af5e313a7e4

@@ -0,0 +1 @@
+the secret code is "pirates"

package/resources/9372c0a4-bb5a-4164-a67f-0af5e313a7e4.json

@@ -0,0 +1 @@
+{"id":"9372c0a4-bb5a-4164-a67f-0af5e313a7e4","name":"SECRET.md","contentType":"text/plain","size":28}

package/src/actions/AdminAction.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@mcphero/core'
+import { Logger } from '@mcphero/logger'
+import z from 'zod'
+
+export const AdminAction = createAction({
+  name: 'admin',
+  description: 'Secret admin action',
+  input: z.object({
+    operation: z.enum(['read', 'write'])
+  }),
+  args: ['operation'],
+  isEnabled: (context) => {
+    return context.has('userId') && context.has('role')
+  },
+  run: async ({ operation }, context) => {
+    const logger = context.get<Logger>('logger')
+    logger.info(`requesting operation ${operation}`)
+    const userId = context.get<string>('userId')
+    const role = context.get<string>('role')
+    logger.info({ userId, role })
+    const success = operation === 'read' || role === 'admin'
+    return { operation, role, success }
+  }
+})

package/src/actions/HelloAction.ts

@@ -0,0 +1,27 @@
+import { createAction } from '@mcphero/core'
+import { Logger } from '@mcphero/logger'
+import z from 'zod'
+
+export interface HelloContext {
+  session: string
+}
+
+export const HelloAction = createAction({
+  name: 'hello',
+  description: 'Say hello',
+  input: z.object({
+    name: z.string(),
+    type: z.enum(['cat', 'dog'])
+  }),
+  args: ['name'],
+  isEnabled: (context) => {
+    const adapter = context.get<string>('adapter')
+    return adapter === 'cli'
+  },
+  run: async ({ name, type }, context) => {
+    const logger = context.get<Logger>('logger')
+    const message = `Hello, ${name}, my ${type}`
+    logger.info(message)
+    return { message }
+  }
+})

package/src/actions/TaskAction.ts

@@ -0,0 +1,23 @@
+import { createAction, createSideloadResource } from '@mcphero/core'
+import { Logger } from '@mcphero/logger'
+import z from 'zod'
+
+export const TaskAction = createAction({
+  name: 'task',
+  description: 'Execute a long-running task',
+  input: z.object({
+    stepCount: z.number().int().min(1).max(10).describe('Number of steps to execute').default(5),
+    stepDuration: z.number().int().min(1000).max(10000).describe('Time duration per step').default(1000)
+  }),
+  run: async ({ stepCount, stepDuration }, context) => {
+    const logger = context.get<Logger>('logger')
+    logger.info(`Running ${stepCount} steps at ${stepDuration}ms each`)
+    for (let i = 1; i <= stepCount; i += 1) {
+      logger.progress({ progress: i, total: stepCount, message: `Executing step ${i} of ${stepCount}` })
+      await new Promise((resolve) => { setTimeout(resolve, stepDuration) })
+    }
+    const buffer = Buffer.from('the secret code is "pirates"', 'utf-8')
+    const resource = await createSideloadResource(buffer, { name: 'SECRET.md', contentType: 'text/plain' })
+    return { completed: stepCount, resources: [resource] }
+  }
+})

package/src/cli.ts

@@ -0,0 +1,18 @@
+import { cli } from '@mcphero/cli'
+import { mcphero } from '@mcphero/core'
+import { AdminAction } from './actions/AdminAction.js'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+async function main() {
+  await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+    .set('userId', 'toby')
+    .set('role', 'admin')
+    .adapter(cli())
+    .action(HelloAction)
+    .action(TaskAction)
+    .action(AdminAction)
+    .start()
+}
+
+main()

package/src/cliProxy.ts

@@ -0,0 +1,14 @@
+import { mcphero } from '@mcphero/core'
+import { cliProxy } from '@mcphero/mcp'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+async function main() {
+  await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+    .adapter(cliProxy({ url: new URL('http://localhost:8080/mcp') }))
+    .action(HelloAction)
+    .action(TaskAction)
+    .start()
+}
+
+main()

package/src/fastify.ts

@@ -0,0 +1,14 @@
+import { mcphero } from '@mcphero/core'
+import { fastify } from '@mcphero/fastify'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+async function main() {
+  await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+    .adapter(fastify({ host: 'localhost', port: 8080, logger: true }))
+    .action(HelloAction)
+    .action(TaskAction)
+    .start()
+}
+
+main()

package/src/http.ts

@@ -0,0 +1,18 @@
+import { mcphero } from '@mcphero/core'
+import { http } from '@mcphero/mcp'
+import { randomUUID } from 'crypto'
+import { AdminAction } from './actions/AdminAction.js'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+async function main() {
+  await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+    .set('sessionId', randomUUID)
+    .adapter(http({ host: 'localhost', port: 8080, allowedHosts: ['localhost'] }))
+    .action(HelloAction)
+    .action(TaskAction)
+    .action(AdminAction)
+    .start()
+}
+
+main()

package/src/stdio.ts

@@ -0,0 +1,14 @@
+import { mcphero } from '@mcphero/core'
+import { stdio } from '@mcphero/mcp'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+async function main() {
+  await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+    .adapter(stdio())
+    .action(HelloAction)
+    .action(TaskAction)
+    .start()
+}
+
+main()

package/src/vercel.ts

@@ -0,0 +1,17 @@
+// Example: Vercel/Next.js App Router route handler
+// File would be at: app/api/mcp/route.ts in a Next.js project
+
+import { mcphero } from '@mcphero/core'
+import { vercel } from '@mcphero/vercel'
+import { HelloAction } from './actions/HelloAction.js'
+import { TaskAction } from './actions/TaskAction.js'
+
+const { adapter, GET, POST, DELETE } = vercel()
+
+await mcphero({ name: 'mcphero', description: 'MCPHero', version: '1.0.0' })
+  .adapter(adapter)
+  .action(HelloAction)
+  .action(TaskAction)
+  .start()
+
+export { GET, POST, DELETE }

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "build",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "build"]
+}