You can control the socket path with:
`
DZX_SOCKET=/tmp/dzx.sock dzx dev
`

$3

Supported methods:
- initialize (returns tools/resources/prompts and protocolVersion)
- notifications/initialized
- tools/list, tools/call (also tools.list, tools.call)
- resources/list, resources/read, resources/subscribe, resources/unsubscribe
- prompts/list, prompts/get
- logging/setLevel, notifications/cancelled, notifications/canceled

Streaming:
- Add ?stream=1 or Accept: text/event-stream to get SSE (event: message).

$3

`ts
import { z } from "zod";
import { defineSchema } from "@dwizi/dzx/schema";

/**
* Adds two numbers.
*/
export default async function add(input: { a: number; b: number }) {
return { sum: input.a + input.b };
}

export const schema = {
input: defineSchema(z.object({
a: z.number(),
b: z.number()
})),
output: defineSchema(z.object({
sum: z.number()
}))
};
`

$3

export const schema = {
input: {
type: "object",
properties: { a: { type: "number" }, b: { type: "number" } },
required: ["a", "b"]
},
output: {
type: "object",
properties: { sum: { type: "number" } }
}
};
`

$3

`ts
/**
* Multiply two numbers.
* @param {object} input
* @param {number} input.a
* @param {number} [input.b] Optional multiplier
*/
export default async function multiply(input) {
// ...
}
`
This generates a JSON Schema with a (required) and b (optional).

$3

1. Create src/context.ts (or .js):
`ts
import type { IncomingMessage } from "http";

export default function createContext(req: IncomingMessage) {
return {
user: req.headers["x-user-id"],
db: process.env.DB_URL
};
}
`

2. Access context in your tool (2nd argument):
`ts
export default async function myTool(args, context) {
console.log(context.user); // Access injected context
}
`

Testing SDK

`ts
import { createTestServer } from "@dwizi/dzx/testing";
import assert from "node:assert";

// 1. Initialize server
const client = await createTestServer({ cwd: process.cwd() });

// 2. Call tool with arguments and optional mock context
const result = await client.callTool("myTool", { a: 1 }, { user: "TestUser" });

assert.equal(result.sum, 2);
`

Resources

Optional frontmatter:
`
---
name: getting-started
description: Quick start guide
---


Getting Started

`
---
name: summarize
description: Summarize text in 3 bullets
inputs:
- name: text
type: string
---
Summarize the following:
{{text}}
`

Planned CLI

Example:
`bash
npx @dwizi/create-dzx@latest --template basic
`

By default it installs dependencies. Use --no-install to skip.

For manual setup in an existing directory:
`bash
dzx init --template basic --force
`

Publish (Checklist)