mcp-ipfs

Instructions

Implementation Reference

• src/tool_handlers.ts:923-941 (handler)

  The handler function that executes the w3_reset tool logic by running the 'w3 reset' command after validating arguments.

  const handleW3Reset: ToolHandler = async (_args) => {
    const parsed = Schemas.W3ResetArgsSchema.safeParse(_args);
    if (!parsed.success)
      throw new Error(`Invalid arguments for w3_reset: ${parsed.error.message}`);
    // const { confirmReset: _confirmReset } = parsed.data; // Value checked by schema
    const { stdout } = await runW3Command(`reset`);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            message:
              "Agent state reset successfully (proofs/delegations removed).",
            output: stdout.trim(),
          }),
        },
      ],
    };
  };

• src/schemas.ts:398-408 (schema)

  Input schema for w3_reset tool using Zod, requiring a confirmation string to prevent accidental resets.

  export const W3ResetArgsSchema = z
    .object({
      confirmReset: z
        .literal("yes-i-am-sure")
        .describe(
          "Must be exactly 'yes-i-am-sure' to confirm resetting agent state (removes proofs/delegations)."
        ),
    })
    .describe(
      "DANGEROUS: Resets the agent state, removing all proofs and delegations but retaining the agent DID. Requires explicit confirmation argument."
    );

• src/tool_handlers.ts:979-979 (registration)

  Maps the 'w3_reset' tool name to its handler function in the toolHandlers export used by the MCP server.

  w3_reset: handleW3Reset,